wcsftime()

Format the time into a wide-character string

Synopsis:

#include <wchar.h>

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

Arguments:

wcs

A pointer to a buffer where the function can store the formatted time.

maxsize

The maximum size of the buffer.

format

The format that you want to use for the time; see "Formats," in the description of strftime().

timeptr

A pointer to a tm structure that contains the time that you want to format.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The wcsftime() function is similar to strftime(), except that wcsftime() works with wide characters.

Returns:

The number of wide characters placed into the array, not including the terminating null character, or 0 if the number of wide characters exceeds maxsize (in this case, the string contents are indeterminate).

If an error occurs, errno is set.

Classification:

ANSI, POSIX 1003.1

See also:

asctime(), asctime_r(), ctime(), ctime_r(), sprintf(), strftime(), tm, tzset()