NAME
catopen
—
open message catalog
SYNOPSIS
#include
<nl_types.h>
nl_catd
catopen
(const
char *name, int
oflag);
DESCRIPTION
Thecatopen
()
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
name substituted for
‘%N
’.
If the oflag argument is
NL_CAT_LOCALE
, the
LC_MESSAGES
environment variable is used to select
the message catalog. If the oflag argument is zero,
the LANG
environment variable is used to select the
message catalog.
RETURN VALUES
Upon successful completion, catopen
()
returns a message catalog descriptor. Otherwise, -1 is returned and
errno is set to indicate the error.
SEE ALSO
STANDARDS
The catopen
() function conforms to
IEEE Std 1003.1-2008 (“POSIX.1”).