NAME

wcsftime − convert date and time to wide character string

SYNOPSIS

#include <wchar.h>

size_t wcsftime(wchar_t ∗wcs, size_t maxsize, const char ∗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(3C) function is passed to the mbstowcs(3C) function as the character string argument, and mbstowcs() 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. 

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. Otherwise, 0 is returned and the contents of the array are indeterminate. 

wcfstime() uses malloc(3C) and should malloc() fail, errno will be set by malloc(). 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

SEE ALSO

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

SunOS 5.6  —  Last change: 20 Dec 1996