|
|
HP-UX Reference > Ccatgets(3C)HP-UX 11i Version 2: December 2007 Update |
|
NAMEcatgets() — get a program message SYNOPSIS#include <nl_types.h> char *catgets( nl_catd catd, int set_num, int msg_num, const char *def_str ); DESCRIPTIONThe catgets() function reads message msg_num in set set_num from the message catalog identified by catd, a catalog descriptor returned from a previous call to catopen() (see catopen(3C)). If the call fails, def_str points to a default message string returned by catgets(). A message longer than NL_TEXTMAX bytes is truncated. The returned message string is always terminated with a null byte. NL_TEXTMAX is defined in <limits.h>. RETURN VALUEIf the call is successful, catgets() returns a pointer to an internal buffer area containing the null-terminated message string. If the call is unsuccessful, catgets() returns a pointer to def_str. ERRORScatgets() fails and sets errno under any of the following conditions:
|
|