catgets(3) - NetBSD Manual Pages

Command: Section: Arch: Collection:  
CATGETS(3)              NetBSD Library Functions Manual             CATGETS(3)


NAME
catgets -- retrieve string from message catalog
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <nl_types.h> char * catgets(nl_catd catd, int set_id, int msg_id, const char *s);
DESCRIPTION
The catgets() function attempts to retrieve message msg_id of set set_id from the message catalog referenced by the descriptor catd. The argument s points to a default message which is returned if the function is unable to retrieve the specified message.
RETURN VALUES
If the specified message was retrieved successfully, catgets() returns a pointer to an internal buffer containing the message string; otherwise it returns s.
ERRORS
The catgets() function will fail if: [EBADF] The catd argument is not a valid message catalog descriptor open for reading. [EINTR] The operation was interrupted by a signal. [ENOMSG] The message identified by set_id and msg_id is not in the message catalog.
SEE ALSO
gencat(1), catclose(3), catopen(3), nls(7)
STANDARDS
The catgets() function conforms to X/Open Portability Guide Issue 4, Version 2 (``XPG4.2''). Major Unix vendors are split over the adoption of the two most important message catalog specifications: catgets or gettext(3). The primary con- cern with the catgets interface is that every translatable string has to define a number (or a symbolic constant) which must correspond to the message in the catalog. Duplicate message IDs are not allowed. Con- structing message catalogs is difficult. NetBSD 9.99 February 12, 2003 NetBSD 9.99
Powered by man-cgi (2021-06-01). Maintained for NetBSD by Kimmo Suominen. Based on man-cgi by Panagiotis Christias.