HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/nan.3m
________________________________________________________________
___ ___
s
setcat(3C) setcat(3C)
(TO BE OBSOLETED)
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 check-
ing 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");
WARNINGS
Obsolescent Interfaces
setcat() is to be obsoleted at a future date.
SEE ALSO
gettxt(3C), pfmt(3C), setlocale(3C), pfmt(3C).
STANDARDS COMPLIANCE
setcat(): SVID3
Section 3−−840 − 1 − HP-UX Release 11i: December 2000
___
___