char
*
catgets(
nl_catd catd
, int set_id
, int msg_id
, const char *s
)
)
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.
)
returns a pointer to an internal buffer containing the message string;
otherwise it returns
s
.
)
function will fail if:
EBADF
]
catd
argument is not a valid message catalog descriptor open for reading.
EINTR
]
ENOMSG
]
set_id
and
msg_id
is not in the message catalog.
)
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 concern 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. Constructing message catalogs is difficult.