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.

HARDWARE DEPENDENCIES

Series 300, 500
Because catgetms(3C) is currently not supported, continue to use getmsg as described above. 

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  —  Version B.1,  May 11, 2021