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)
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.
APPLICATION USAGE
setcat()
is thread-safe and async-cancel-safe.
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");
STANDARDS COMPLIANCE
setcat(): SVID3
