SETCAT(3C-SVR4)     RISC/os Reference Manual      SETCAT(3C-SVR4)



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 pfmt(), lfmt() or gettxt()
     which do not explicitly specify a message catalog.

     catalog must be limited to 14 characters.  These characters
     must be selected from a set of all characters 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 catalog name, Subsequent calls to gettxt(), pfmt()
     or lfmt() that do not explicitly specify a catalog name will
     use

          Message not found!!\n

     as 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
     environ(5), gettxt(3C), lfmt(3C), pfmt(3C), setlocale(3C).










                        Printed 11/19/92                   Page 1