setcat.3c (2010 09)

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 speciﬁes the ﬁle to use as the default catalog. The ﬁle name is limited to 14 characters. No

checking is done to make sure that the ﬁle 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 ﬁle:

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.

PAGE 1
setcat(3C) setcat(3C) (TO BE OBSOLETED) NAME setcat() - set the default message catalog SYNOPSIS #include 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.
PAGE 2
(Notes) A (Notes) sA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010