HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

521

522

523

524

525

526

527

528

529

530

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/nan.3m

________________________________________________________________

___ ___

wcsftime(3C) wcsftime(3C)

RETURN VALUE

If the total number of resulting wide characters including the terminating null wide character is not more

than maxsize, wcsftime() returns the number of wide characters placed into the array pointed to by

ws, not including the terminating null wide character. Otherwise, zero is returned and the contents of the

array are indeterminate.

EXAMPLES

If the timeptr argument contains the following values:

timeptr->tm_sec = 4;

timeptr->tm_min = 9;

timeptr->tm_hour = 15;

timeptr->tm_mday = 4;

timeptr->tm_mon = 6;

timeptr->tm_year = 88;

timeptr->tm_wday = 1;

timeptr->tm_yday = 185;

timeptr->tm_isdst = 1;

the following combinations of the LC_TIME category and format strings produce the indicated output:

LC_TIME Format String Output

en_US.roman8 %x Mon, Jul 4, 1988

de_De.roman8 %x Mo., 4. Juli 1988

en_US.roman8 %X 03:09:04 PM

fr_FR.roman8 %X 15h09 04

any * %H:%M:%S 15:09:04

any * %.1H:%.1M:%.1S 15:9:4

any * %2.1H:%-3M:%03.1S 15:9 :004

* The directives used in these examples are not affected by the LC_TIME category of the locale.

WARNINGS

The function

tzset() is called upon every invocation of wcsftime() (whether or not the time zone

name is copied to the output array).

The range of values for %S ([0,61]) extends to 61 to allow for the occasional one or two leap seconds. How-

ever, the system does not accumulate leap seconds and the tm structure generated by the functions

localtime() and gmtime() (see ctime(3C)) never reﬂects any leap seconds.

Results are undeﬁned if values contained in the structure pointed to by timeptr exceed the ranges deﬁned

for the

tm structure (see ctime(3C)) or are not consistent (such as if the tm_yday element is set to 0,

indicating the ﬁrst day of January, while the

tm_mon element is set to 11, indicating a day in December).

AUTHOR

wcsftime() was developed by OSF and HP.