Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
wcsftime(3C)		 Standard C Library Functions		  wcsftime(3C)

NAME
       wcsftime	- convert date and time	to wide	character string

SYNOPSIS
       #include	<wchar.h>

   XPG4	and SUS
       size_t wcsftime(wchar_t *wcs, size_t maxsize, const char	*format, const
       struct tm *timptr);

   Default and other standards
       size_t wcsftime(wchar_t *restrict wcs, size_t  maxsize,	const  wchar_t
       *restrict format, const struct tm *restrict timptr);

DESCRIPTION
       The wcsftime() function is equivalent to	the strftime(3C) function, ex-
       cept that:

	 o  The	argument wcs points to the initial  element  of	 an  array  of
	    wide-characters into which the generated output is to be placed.

	 o  The	 argument maxsize indicates the	maximum	number of wide-charac-
	    ters to be placed in the output array.

	 o  The	argument format	is a wide-character string and the  conversion
	    specifications  are	  replaced by corresponding sequences of wide-
	    characters.

	 o  The	return value indicates the number of wide-characters placed in
	    the	output array.

       If  copying  takes  place between objects that overlap, the behavior is
       undefined.

RETURN VALUES
       If the total number of resulting	wide character	codes  (including  the
       terminating  null  wide-character  code)	is no more than	maxsize, wcsf-
       time() returns the number of wide-character codes  placed into the  ar-
       ray  pointed to by wcs, not including the terminating null wide-charac-
       ter code. Otherwise, 0 is returned and the contents of  the  array  are
       indeterminate.

       The wcfstime() function uses malloc(3C) and should malloc() fail, errno
       will be set by malloc().

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe with exceptions	   |
       +-----------------------------+-----------------------------+

SEE ALSO
       malloc(3C), setlocale(3C), strftime(3C),	attributes(5), standards(5)

NOTES
       The wcsftime() function can be used safely  in  multithreaded  applica-
       tions,  as  long	as setlocale(3C) is not	being called to	change the lo-
       cale.

SunOS 5.10			  1 Nov	2003			  wcsftime(3C)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=wcsftime&sektion=3c&manpath=SunOS+5.10>

home | help