wcsftime(3C)                                                   wcsftime(3C)

NAME
     wcsftime - convert date and time to wide character string

SYNOPSIS
     #include <wchar.h>

     sizet wcsftime(wchart *wcs, sizet maxsize, const wchart *format,
                     const struct tm *timptr);

DESCRIPTION
     The wcsftime() function places wide character codes into the array
     pointed to by wcs as controlled by the string pointed to by format.

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

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

     The wcsftime() function will fail if:

     ENOSYS    The function is not supported.

RESULT
     If the total number of resulting wide character codes including the
     terminating null wide character code is no longer than maxsize, the
     wcsftime() function returns the number of wide character codes placed
     into the array pointed to by wcs, not including the terminating null
     wide character code. Otherwise zero 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
     mbstowcs(3C), strftime(3C), LCTIME(4), wchar(5).


















Page 1                       Reliant UNIX 5.44                Printed 11/98