Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > S

setcat(3C)

TO BE OBSOLETED
HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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.

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.

STANDARDS COMPLIANCE

setcat(): SVID3

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.