Pegasus InfoCorp: Web site design and web software development company

CATOPEN (3)

open/close a message catalog

SYNOPSIS

    #include <features.h> #include <nl_types.h>

    B
    nl_catd catopen(name, flag)
    char *name;
    int flag;
    R
    

    B
    void catclose(catalog)
    nl_catd catalog;
    R
    

DESCRIPTION

    "catopen" "" "\fLcatopen\fR \(em open a message catalog" "" "catclose" "" "\fLcatclose\fR \(em close a message catalog" ""

    catopen(\|) opens a message catalog and returns a catalog descriptor. name specifies the name of the message catalog to be opened. If name specifies and absolute path, (i.e. contains a ` / ' ) then name specifies a pathname for the message catalog. Otherwise, the environment variable NLSPATH is used with name substituted for %N (see locale (7)). If NLSPATH does not exist in the environment, or if a message catalog cannot be opened in any of the paths specified by \s-1NLSPATH\s0 , then the following paths are searched in order

      /etc/locale/LC_MESSAGES /usr/lib/locale/LC_MESSAGES /usr/lib/locale/name/LC_MESSAGES

    In all cases LC_MESSAGES stands for the current setting of the \s-1LC_MESSAGES\s+1 category of locale from a previous call to setlocale () and defaults to the "C" locale. In the last search path name refers to the catalog name.

    The flag argument to catopen is used to indicate the type of loading desired. This should be either MCLoadBySet or MCLoadAll . The former value indicates that only the required set from the catalog is loaded into memory when needed, whereas the latter causes the initial call to catopen () to load the entire catalog into memory.

    catclose(\|) closes the message catalog identified by catalog . It invalidates any subsequent references to the message catalog defined by catalog .

RETURN VALUES

    catopen(\|) returns a message catalog descriptor of type nl_catd on success. On failure, it returns -1.