CATOPEN(3) | Library Functions Manual | CATOPEN(3) |
catopen
— open
message catalog
Standard C Library (libc, -lc)
#include
<nl_types.h>
nl_catd
catopen
(const
char *name, int
oflag);
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:
LANG
environment variable or the
LC_MESSAGES
category (see below).LANG
environment
variable or from the LC_MESSAGES
category.LANG
environment
variable or from the LC_MESSAGES
category.LANG
environment
variable or from the LC_MESSAGES
category.An empty string is substituted for undefined values.
Path names templates defined in NLSPATH
are separated by colons (‘:’). 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
X/Open Portability Guide Issue 4
(“XPG4”) standard. You can specify 0 for compatibility
with X/Open Portability Guide Issue 3
(“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.
Upon successful completion, catopen
()
returns a message catalog descriptor. Otherwise, (nl_catd) -1 is returned
and errno is set to indicate the error.
EINVAL
]ENAMETOOLONG
]ENOENT
]ENOMEM
]The catopen
() function conforms to
IEEE Std 1003.1-2001 (“POSIX.1”).
February 12, 2005 | macOS 14.6 |