pSOSystem System Calls - Read

pREPC+ System Calls localtime_r
localtime_r (Reentrant) Converts the calendar time to broken-down time.
#include
struct tm *localtime_r (
const time_t *timer, /* pointer to calendar time */
struct tm *resultp /* pointer to result */
)
Description
Arguments
Return Value
Error Codes
localtime_r() is the reentrant version of the ANSI function localtime(), as
defined by POSIX 1003.1c. It converts the calendar time pointed to by timep into
broken-down time and stores it in the structure pointed to by resultp. The time is
represented in local time.
The calendar time is generally obtained through a call to time().
timer Points to the calendar time.
resultp Points to the tm structure where localtime_r() stores the result.
The tm structure is defined in the mktime() description on page 3-
111.
Upon success, localtime_r() returns the value of resultp. On failure, it returns
NULL; the only cause of failure is if timer points to a negative value.
No error codes are returned.
pSOSystem System Calls 3-93
3