[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Base Operating System and Extensions Technical Reference, Volume 2

wcsftime Subroutine

Purpose

Converts date and time into a wide character string.

Library

Standard C Library (libc. a)

Syntax

#include <time.h>
size_t wcsftime (WcStringMaxsizeFormatTimPtr)
wchar_t *WcString;
size_t Maxsize;
const wchar_t *Format;
const struct tm *TimPtr;

Description

The wcsftime function is equivalent to the strftime function, except that:

If copying takes place between objects that overlap, the behaviour is undefined.

Parameters

WcString Contains the output of the wcsftime subroutine.
Maxsize Specifies the maximum number of bytes (including the wide character null-terminating byte) that may be placed in the WcString parameter.
Format specifiers are the same as in strftime function.
TimPtr Contains the data to be converted by the wcsftime subroutine.

Return Values

If successful, and if the number of resulting wide characters (including the wide character null-terminating byte) is no more than the number of bytes specified by the Maxsize parameter, the wcsftime subroutine returns the number of wide characters (not including the wide character null-terminating byte) placed in the WcString parameter. Otherwise, 0 is returned and the contents of the WcString parameter are indeterminate.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The mbstowcs subroutine, strfmon subroutine, strftime subroutine, strptime subroutine.

National Language Support Overview for Programming, Understanding Time and Monetary Formatting Subroutines, Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]