Updated: 2025/Nov/16

Please read Privacy Policy. It's for your privacy.

CATOPEN(3)                 Library Functions Manual                 CATOPEN(3)

NAME
     catopen - open message catalog

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <nl_types.h>

     nl_catd
     catopen(const char *name, int oflag);

DESCRIPTION
     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 name substituted for %N.

     The oflag argument is reserved for future use and should be set to zero.

RETURN VALUES
     Upon successful completion, catopen() returns a message catalog
     descriptor.  Otherwise, (nl_catd) -1 is returned and errno is set to
     indicate the error.

ERRORS
     [ENOMEM]           Insufficient memory is available.

SEE ALSO
     gencat(1), catclose(3), catgets(3), nls(7)

STANDARDS
     The catopen() function conforms to X/Open Portability Guide Issue 3
     ("XPG3").

NetBSD 11.99                     May 29, 1994                     NetBSD 11.99