NAME

getmsg − get message from a catalogue

SYNOPSIS

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

DESCRIPTION

Getmsg reads up to buflen−1 bytes of a message string into the area pointed to by buf. A null byte is inserted to terminate the string placed in the buffer.

Fd is the file descriptor, returned by a call to open(2) (see nl_catopen(3C) and catopen(3C)), of the catalogue containing the messages. Set_num groups messages together into logical units.  For instance, messages in Finnish could be grouped in set number 6 to match the language ID for Finnish (see langinfo(3C) and langid(5)).

DIAGNOSTICS

Getmsg returns a pointer to an empty (null) string if fd is invalid or set_num or msg_num are not in the catalogue. 

WARNINGS

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

AUTHOR

Getmsg was developed by the Hewlett-Packard Company. 

SEE ALSO

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

INTERNATIONAL SUPPORT

8- and 16-bit data, messages. 

Hewlett-Packard Company  —  May 11, 2021