wcsftime(3C)

NAME
     wcsftime - convert date and time to wide character string

SYNOPSIS
     #include <wchar.h>

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

DESCRIPTION
     wcsftime places wide-character codes into the array pointed to by wcs as
     controlled by the string or the wide character string pointed to by
     format.  The format string or wide character 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
     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
     strftime(3C), strftime(4), mbstowcs(3C), <wchar.h>.

NOTES
     There are two types of wcsftime functions in n32 and 64 bit C libraries
     for IRIX 6.5.17 and later versions. One is XPG4 type which has been in C
     library, and another is XPG5 type function. The difference is a third
     argument type, which is const char *format for XPG4 and const wchar_t
     *format for XPG5. Old programs calling wcsftime function have XPG4
     behavior of the function for backward compatibility. When XPG5 behavior
     is required, new programs must be compiled with the wchar.h header file
     and _XOPEN_SOURCE set to 500. XPG5 type function is not supported in o32
     C library.
     The XPG5 type wcsftime function is actually defined as a static inline
     function in wchar_core.h, and it calls a new function _xpg5_wcsftime
     which is specific to IRIX 6.5.17 and later. Therefore applications that
     call XPG5 type wcsftime should check the existence of the new symbol.

            #include <wchar.h>
            #include <optional_sym.h>

            if (_MIPS_SYMBOL_PRESENT(_xpg5_wcsftime)) {
                  wcsftime(wcs, maxsize, wcs_format, timeptr);
            } else {
                  ...
            }


     Because the static inline function is defined in each source file that
     includes wchar.h, these static functions will have different addresses in
     any cases that inline expansion is not performed. This may cause problems
     if the address of the function is examined in programs.  To avoid this
     problem, use -D_XPG5_WCSFTIME_USER_DEFINED compile option to disable the
     static inline definition in wchar_core.h, and define a user defined
     function with below definition:

          size_t
          wcsftime(wchar_t *_wcs, size_t _maxsize, const wchar_t *_format, const struct tm *_timptr)
          {
                  return(_xpg5_wcsftime(_wcs, _maxsize, _format, _timptr));
          }


     Use the compile option always, when a user defined XPG5 wcsftime function
     is required.