ctime_r(3STDC)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | ATTRIBUTES | SEE ALSO | STANDARDS

NAME

ctime_r, asctime_r, gmtime_r, localtime_r- Transform binary date and time value to ASCII; Reentrent version

SYNOPSIS

#include <time.h>

char * ctime_r(const time_t * clock, char * result);
char * asctime_r(const struct tm * tm, char * result);
struct tm * localtime_r(const time_t * clock, struct tm * result);
struct tm * gmtime_r(const time_t * clock, struct tm * result);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

DESCRIPTION

The ctime_r() gmtime_r() asctime_r() and localtime_r() functions perform the same task as ctime (3STDC), gmtime (3STDC), asctime (3STDC), and localtime (3STDC), with the difference that they do not store their result in a static buffer. Instead, the necessary storage must be allocated by the caller and a pointer to it passed as the result argument.

For asctime_r() result must point to a 26 byte character array. For the others, result must point to a memory area large enough to hold a struct tm .

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

asctime(3STDC) , ctime(3STDC) , localtime(3STDC) , gmtime(3STDC) , tzset(3STDC)

STANDARDS

These routines conform to POSIX.1c.

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | ATTRIBUTES | SEE ALSO | STANDARDS