Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

wcsftime(3) Guardian Native C Library Calls Reference Manual
NAME
wcsftime - Converts a date and time to a wide-character string
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS For TNS/E Target Compilations on H06.09 and Later RVUs
This version of the function applies to TNS/E target compilations on H06.09 and later H-series
RVUs.
#include <wchar.h>
size_t wcsftime(
wchar_t *wcs,
size_t maxsize,
const wchar_t *format,
const struct tm *timptr);
SYNOPSIS For Other RVUs
This version of the function applies to TNS/R target compilations and to TNS/E target compila-
tions on H06.08 and earlier H-series RVUs.
#include <wchar.h>
size_t wcsftime(
wchar_t *wcs,
size_t maxsize,
const char *format,
const struct tm *timptr);
PARAMETERS
wcs Points to the wide-character array that contains the output date and time string.
maxsize Specifies the maximum number of wide-characters to be written to the array
pointed to by the wcs parameter.
format Points to a sequence of format codes that specify the format of the date and time
to be written to the output string. (See the DESCRIPTION section for more
information.) The data type of this parameter depends on the target compilation
and the RVU the system is running:
• If the target is TNS/R or if the target is TNS/E and the system is running
H06.08 or an earlier H-series RVU, this parameter must reference a char
string.
• If the target is TNS/E and the system is running H06.09 or a later H-
series RVU, this parameter must reference a wchar_t string. If you have
an existing object file compiled from source text that specifies a value of
type char for this parameter, you can continue to use the object file.
However, if you recompile the same source text, you must change each
reference to wcsftime() so that the format parameter specifies a wchar_t
string. If you do not specify the correct data type for this parameter, the
compiler issues an error.
7−140 Hewlett-Packard Company 527192-018