NAME

setcat() − set the default message catalog

SYNOPSIS

#include <pfmt.h>

char *setcat(const char *msgcat);

DESCRIPTION

The setcat() routine sets the default message catalog for use by other formatting routines (see gettxt(3C), pfmt(3C), and vpfmt(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, setcat() returns a pointer to the default catalog.  Otherwise, setcat() returns a NULL pointer. 

EXAMPLES

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

setcat("my_appl_cat");
pfmt(stderr, MM_INFO,":1:The file is writable");

SEE ALSO

gettxt(3C), pfmt(3C), setlocale(3C), vpfmt(3C). 

STANDARDS COMPLIANCE

setcat(): SVID3

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996