CATREAD(3C)

NAME

catread − MPE/RTE-style message catalog support

SYNOPSIS

int catread (fd, set_num, msg_num, msg_buf, buflen [,arg]...)
int fd, set_num, msg_num, buflen;
char *msg_buf, *arg;

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: HP

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

DESCRIPTION

Catread is layered on getmsg(3C) for supporting message catalog applications from MPE/RTE. Refer to the external specifications for message catalogs on these systems for use of this routine.

The message read from the catalog may have embedded formatting information in the form ![digit]. An exclamation mark followed by a digit n is replaced by the nth argument string. If exclamation marks are not numbered, they are replaced by the arguments in serial order. Either all or none must be numbered.

If successful, returns the number of non-null bytes placed in the buffer.

DIAGNOSTICS

Catread returns a negative integer if set_num or msg_num are not found in the catalog.

Museum