nlfmtclock(3X)
NAME
nlfmtclock() − format MPE time of day using localized format
SYNOPSIS
#include <portnls.h>
void nlfmtclock(
unsigned int time,
char *outstr,
short int langid,
unsigned short int err[2]
);
DESCRIPTION
nlfmtclock() formats the time of day obtained with the clock routine, according to the clock format defined for the specified language.
Arguments to nlfmtclock() are used as follows:
time An unsigned int obtained from the clock routine:
| Bits | 0 | 7 | 8 | 15 |
| _ | _ | _ | _ | |
| Hour of Day | Minute of Hour | |||
| _ | _ | _ | _ | |
| Bits | 16 | 23 | 24 | 31 |
| _ | _ | _ | _ | |
| Seconds | Tenths of Seconds | |||
| _ | _ | _ | _ | |
outstr An 8-byte buffer in which the formatted time of day is returned.
langid A short integer specifying the language whose clock format is to be used.
err The first element of this array contains the error number. The second element is always zero. If the call is successful, both elements contain zero.
Error # Meaning
2 Specified language is not configured.
3 Invalid time format.
WARNINGS
This routine is provided for compatibility with MPE, a proprietary HP operating system. See portnls(5) for more information on the use of this routine. Use the Native Language Support routines for C programmers described by hpnls(5) for HP-UX NLS support.
AUTHOR
nlfmtclock() was developed by HP.
SEE ALSO
clock(3X), nlconvclock(3X), portnls(5).
EXTERNAL INFLUENCES
International Code Set Support
Single- and multi-byte character code sets are supported.
Hewlett-Packard Company — HP-UX Release 10.20: July 1996