nlconvclock(3X)
NAME
nlconvclock() − check and convert time string to MPE internal format
SYNOPSIS
#include <portnls.h>
unsigned int nlconvclock(
const char *instr,
short int leninstr,
short int langid,
unsigned short int err[2]
);
DESCRIPTION
nlconvclock() converts instr to a general time format as returned by nlinfo(3X) itemnumber 3. This routine is the inverse of nlfmtclock(3X). Note that the seconds and tenths of seconds are always set to zero.
The arguments to nlconvclock() are used as follows:
instr A character buffer containing the time to be converted.
leninstr An unsigned short specifying the length of the buffer.
langid A short containing the language ID.
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.
4 Invalid length.
RETURN VALUE
nlconvclock() returns the time in the format:
| Bits | 0 | 7 | 8 | 15 |
| _ | _ | _ | _ | |
| Hour of Day | Minute of Hour | |||
| _ | _ | _ | _ | |
| Bits | 16 | 23 | 24 | 31 |
| _ | _ | _ | _ | |
| Seconds | Tenths of Seconds | |||
| _ | _ | _ | _ | |
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
nlconvclock() was developed by HP.
SEE ALSO
clock(3X), nlfmtclock(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