Manual Pages for UNIX Operating System command usage for man wcsftime

Standard C Library Functions                         wcsftime(3C)



NAME
     wcsftime - convert date and time to wide character string

SYNOPSIS
     #include 


  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, except that:

         o    The argument wcs points to the initial  element  of
              an  array  of  wide-characters  into which the gen-
              erated output 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
              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, 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.






SunOS 5.11           Last change: 1 Nov 2003                    1






Standard C Library Functions                         wcsftime(3C)



     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             |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


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.

























SunOS 5.11           Last change: 1 Nov 2003                    2