default

setcat(3C)																setcat(3C)

NAME

       setcat() - set the default message catalog

SYNOPSIS

DESCRIPTION

       The routine sets the default message catalog for use by other formatting routines (see gettxt(3C) and pfmt(3C)).

       msgcat specifies the file to use as the default catalog.  The file name is limited to 14 characters.  No checking is done to make sure that
       the file exists.  The value of msgcat determines what happens to the default message catalog:

	      string	     Sets the default message catalog to string.

	      NULL	     Returns a pointer to the current default message catalog.	The default catalog is not changed.

	      empty string   Resets to no catalog.

RETURN VALUE

       Upon successful completion, returns a pointer to the default catalog.  Otherwise, returns a NULL pointer.

EXAMPLES

       The following example gets its message from the message catalog file:

WARNINGS

   Obsolescent Interfaces
       is to be obsoleted at a future date.

SEE ALSO

       gettxt(3C), pfmt(3C), setlocale(3C), pfmt(3C), thread_safety(5).

STANDARDS COMPLIANCE

								  TO BE OBSOLETED							setcat(3C)