HP 9000 User Manual page 114

attempt to open.
/prog.
Note that if
LANG
is not set, the first path would be
/usr/1oca1/1ib/prog. cat
and would probably result in a failure to find a
catalog.
If
catopen
can't find a message catalog with the path names specified in
NLSPATH,
it searches the default path:
/usr/1ib/n1s/1.1/1.t/1.c/1.N.cat
where:
1.1
is replaced by the language element of
LANG, 1.t
is replaced by the
territory element of
LANG,
and
1.c
is replaced by the codeset element of
LANG.
This is summarized in the following table:
Table 7-1. Summary of NLSPATH Replacement Specifiers
Replacement Expansion by NLS
Specifiers
%L
Replaced by the value of
LANG.
%N
Replaced by the name parameter passed to
catopen.
%1 Replaced by the language element of LANG.
%t
Replaced by the territory element of LANG.
%c
Replaced by the codeset element of
LANG.
For further details on
LANG
and
NLSPATH,
see environ(5) in the HP-UX
Reierence
Retrieving Messages
Once the message catalog is open, the program can retrieve messages from the
catalog using:
catgets(catd, set_num, msg_num, dei_str);
where catd is the catalog descriptor returned by
catopen,
seLnum and
msg_num identify the message to be retrieved, and dei_str ("default string")
is a string that is returned if the call fails. Ordinarily dei_str is the
C
locale
message.
The Message Catalog System 7-7
7