Standard C Library Functions                         wcsftime(3C)



NAME
     wcsftime - convert date and time to wide character string

SYNOPSIS
     #include 


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


  Default and other standards
     sizet wcsftime(wchart *restrict wcs, sizet maxsize,
          const wchart *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().

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
     ATRIBUTE TYPE               ATRIBUTE 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
     applications,  as  long as setlocale(3C) is not being called
     to change the locale.



























SunOS 5.11           Last change: 1 Nov 2003                    2