GETMSG(3C)

NAME

getmsg − get message from a catalog

SYNOPSIS

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

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: HP

Native Language Support:
8−bit data, customs, messages

DESCRIPTION

Getmsg attempts to read 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) the catalog containing the messages. Set_num is available to group messages together into a logical unit. For instance, messages in Finnish could be grouped in set number 6 to match the language id for Finnish (See currlangid(3C) and langid(7)).

DIAGNOSTICS

Returns a pointer to an empty (null) string if fd is invalid or set_num or msg_num is not in the catalog.

Museum