NAME

getmsg − get message from a catalog

SYNOPSIS

char *getmsg (fildes, set_num, msg_num, buf, buflen)
int fildes, set_num, msg_num, buflen;
char buf[];

DESCRIPTION

Getmsg reads message msg_num in set set_num from the message catalog identified by fildes, a file descriptor returned from a previous call to open(2). The returned message is stored in buf, a buffer of size buflen bytes. 

A message longer than buflen-1 bytes is silently truncated. The returned message is always terminated with a null byte.

RETURN VALUE

If successful, getmsg returns a pointer to the message in buf. Otherwise, if fildes is invalid or if set_num or msg_num is not in the catalog, getmsg returns a pointer to an empty string. 

WARNINGS

This routine is provided for historical reasons only.  Use of the equivalent routine catgetmsg(3C) is recommended.

AUTHOR

Getmsg was developed by HP. 

SEE ALSO

gencat(1), insertmsg(1), read(2), catgetmsg(3C), catopen(3C), nl_catopen(3C), hpnls(5). 

EXTERNAL INFLUENCES

International Code Set Support

Single- and multi-byte character code sets are supported. 

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989