Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

calendar(3X)

nlfmtcalendar(3X)

portnls(5)

nlfmtlongcal(3X)

NAME

nlfmtlongcal() − format an MPE packed date using a long calendar format

SYNOPSIS

#include <portnls.h>

void nlfmtlongcal(

unsigned short int date,
char *outstr,
short int langid,
unsigned short int err[2]

);

DESCRIPTION

nlfmtlongcal() formats the supplied date according to the long calendar format.  The formatting is done according to the template returned by nlinfo(3X), itemnumber 30. 

Arguments to nlfmtlongcal() are used as follows:

date A short integer value containing a date in the packed date format:

Bits 0 6 7 15
_ _ _ _
Year of Century Day of Year
_ _ _ _

outstr A 36-byte buffer to which the formatted long calendar date is returned, padded with blanks if necessary. 

langid An ID number specifying which language-specific 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 date 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

nlfmtlongcal() was developed by HP. 

SEE ALSO

calendar(3X), nlfmtcalendar(3X), portnls(5). 

EXTERNAL INFLUENCES

International Code Set Support

Single- and multi-byte character code sets are supported. 

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026