.TLNAME - convert time zone locale reference token to name.

Alternate Entry Name: _TLNAME

Usage:

B:
  %b/manif/t_ctrl
  name = .tlname(token);

C:
  #include <t_ctrl.h>
  const char *_tlname(_T_locale ref);

Examples:

old = .tswitch("GMT");  /* Start working in GMT */
  ...
.tswitch(.tlname(old)); /* switch back to old locale */

Where:

token

is a time zone locale reference value. This can either be zero to refer to the current default locale, or it can be a value returned by .TSWITCH or .TLOCALE.

name

is a C pointer to a string with the name associated with this locale.

Description:

.TLNAME converts a time zone locale reference to an ASCII string that may be displayed or passed to .TSWITCH. The time zone locale reference values generated by .TSWITCH and .TLOCALE are only valid during the current program execution, so if you want to record locale data in a file for later use, you need to use .TLNAME to produce an ASCII locale name that will be valid in another program.

See Also:

expl b tz

for background on time zones and the error time zone.

expl b lib .tlocale

for the inverse function.

Copyright © 1996, Thinkage Ltd.