wcsftime()

Updated: April 19, 2023

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

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes