wcsftime(3C)							  wcsftime(3C)

NAME    [Toc]    [Back]

     wcsftime -	convert	date and time to wide character	string

SYNOPSIS    [Toc]    [Back]

     #include <wchar.h>

     size_t wcsftime (char *wcs, size_t	maxsize, const char *format,
	 const struct tm *timeptr);

DESCRIPTION    [Toc]    [Back]

     wcsftime places wide-character codes into the array pointed to by wcs as
     controlled	by the string pointed to by format.  The format	string
     consists of zero or more directives and ordinary characters.  All
     ordinary characters (including the	terminating null character) are	copied
     unchanged into the	array.	For wcsftime, no more than maxsize characters
     are placed	into the array.

     This function behaves as if the character string generated	by strftime is
     passed to mbstowcs	as the character string	argument, and mbstowcs places
     the result	in the wide character string argument of wcsftime up to	a
     limit of maxsize wide-character codes.

RETURN VALUE    [Toc]    [Back]

     If	the total number of resulting wide character codes including the
     terminating null wide-character code is no	more than maxsize , wcsftime
     returns the number	of wide-character codes	placed into the	array pointed
     to	by wcs , not including the terminating null wide-character code.
     Otherwise 0 is returned and the contents of the array are indeterminate.
     If	the function is	not implemented, errno will be set to indicate the
     error.

SEE ALSO    [Toc]    [Back]

     strftime(3C), strftime(4),	mbstowcs(3C), <wchar.h>.


									PPPPaaaaggggeeee 1111