setcat(3C)    27 Jan 1992 (C Programming Language Utilities)     setcat(3C)

NAME
     setcat - define default catalog

SYNOPSIS
     #include <pfmt.h>

     char *setcat(const char *catalog);

DESCRIPTION
     The routine setcat() defines the default message catalog to be used by
     subsequent calls to lfmt(), pfmt() or gettxt() which do not explicitly
     specify a message catalog.

     catalog must be limited to 14 characters. These characters must be
     selected from the set of all character values, excluding \0 (null) and
     the ASCII codes for / (slash) and : (colon).

     setcat() assumes that the catalog exists. No checking is done on the
     argument.

     A NULL pointer passed as an argument will result in the return of a
     pointer to the current default message catalog name. A pointer to an
     empty string passed as an argument will cancel the default catalog.

     If no default catalog is specified, or if catalog is an invalid cata-
     log name, subsequent calls to gettxt(), pfmt() or lfmt() that do not
     explicitly specify a catalog name will use "Message not found!!\n" as
     the default string.

RETURN VALUE
     Upon success, setcat() returns a pointer to the catalog name. Upon
     failure, setcat() returns a NULL pointer.

EXAMPLE
          setcat("test");
          gettxt(":10", "hello world\n")

SEE ALSO
     gettxt(3C), lfmt(3C), pfmt(3C), setlocale(3C), environ(5).
















Page 1                       Reliant UNIX 5.44                      1, 1927