.TINIT - initialize time zone definitions.

Alternate Entry Name: _TINIT

Usage:

B:
   %b/manif/t_ctrl
   status = .tinit(filename);

C:
   #include <t_ctrl.h>
   int _tinit(const char *filename);

Description:

status = .tinit("user/mydefs");

Where:

filename

is the name of a processed time zone definition file. If this is a null pointer, the library uses the standard time zone definition file.

status

is zero if the operation succeeds. If .TINIT fails to read the file for some reason, it returns the positive value of the ERRNO variable, set when the read operation failed.

Description:

.TINIT reads time zone definitions from a time zone definition file that has been produced by TZDATA. The time zone definitions are stored in memory and replace the default definitions.

The first time your program calls any of the B library date/time functions, the library automatically executes

 .tinit(NULL);

to initialize time zone definitions from the default definition file.

After .TINIT has set up time zone definitions, it automatically executes the function call

 .tswitch("default");

to set the current time zone locale to the default.

See Also:

expl tzdata

for information on the TZDATA command.

expl b tz

for background on time zones.

expl b lib .tswitch

for info on .TSWITCH.

Copyright © 1996, Thinkage Ltd.