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 *wcs, size_t maxsize, const  wchar_t
     *format, const struct tm *timptr);

DESCRIPTION

     The wcsftime() function is equivalent  to  the  strftime(3C)
     function, except that:

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

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

        o  The argument format is a wide-character string and the
           conversion specifications are  replaced by correspond-
           ing 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, wcsftime() returns the  number  of  wide-
     character  codes   placed  into the array pointed to by wcs,
     not including the terminating null wide-character code. Oth-
     erwise,  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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | MT-Level                    | MT-Safe with exceptions     |
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|

SEE ALSO

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

NOTES

     The wcsftime() function can be used safely in  multithreaded
     applications,  as  long as setlocale(3C) is not being called
     to change the locale.