NLCONVCLOCK(3X)
NAME
nlconvclock − check and converts a time string to the MPE internal format
SYNOPSIS
unsigned int nlconvclock(instr, leninstr, langid, err)
char *instr;
short leninstr, langid;
unsigned short 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, another 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 on 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 7.0: Sept 1989