The
catopen()
function opens the message catalog specified by
name
and returns a message catalog descriptor.
If
name
contains a
'/'
then
name
specifies the full pathname for the message catalog, otherwise the value
of the environment variable
NLSPATH
is used with
the following substitutions:
|
| amp;%N
|
The value of the
name
argument.
|
| amp;%L
|
The value of the
LANG
environment variable or the
LC_MESSAGES
category (see below).
|
| amp;%l
|
The language element from the
LANG
environment variable or from the
LC_MESSAGES
category.
|
| amp;%t
|
The territory element from the
LANG
environment variable or from the
LC_MESSAGES
category.
|
| amp;%c
|
The codeset element from the
LANG
environment variable or from the
LC_MESSAGES
category.
|
| amp;%%
|
A single % character.
|
|
An empty string is substituted for undefined values.
Path names templates defined in
NLSPATH
are separated by colons
('amp;:').
A leading or two adjacent colons
is equivalent to specifying %N.
If the
oflag
argument is set to the
NL_CAT_LOCALE
constant,
LC_MESSAGES
locale category used to open the message catalog; using
NL_CAT_LOCALE
conforms to the
-xpg4
standard.
You can specify 0 for compatibility with
-xpg3;
when
oflag
is set to 0, the
LANG
environment variable
determines the message catalog locale.
A message catalog descriptor
remains valid in a process until that process closes it, or
until a successful call to one of the
exec(3)
function.
