*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->NetBSD man pages -> catgets (3)              



NAME    [Toc]    [Back]

     catgets - retrieve string from message catalog

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <nl_types.h>

     char *
     catgets(nl_catd catd, int set_id, int msg_id, const char *s);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     If the specified message was retrieved successfully, catgets() returns a
     pointer to an internal buffer containing the message string; otherwise it
     returns s.

ERRORS    [Toc]    [Back]

     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    [Toc]    [Back]

     catclose(3), catopen(3)

STANDARDS    [Toc]    [Back]

     The catgets() function conforms to X/Open Portability Guide Issue 4.2

BSD                            February 8, 1998                            BSD
[ Back ]
 Similar pages
Name OS Title
catgets Tru64 Retrieve a message from a catalog
gettxt Tru64 Retrieves a text string from a message catalog
gettxt IRIX retrieve a text string from a message database
tt_message_status_string HP-UX retrieve the character string stored with the status attribute for a message
dspmsg Tru64 Displays a selected message from a message catalog
catgetmsg IRIX Reads a message from a message catalog
catopen NetBSD open message catalog
catopen OpenBSD open message catalog
catclose OpenBSD close message catalog
catclose NetBSD close message catalog
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service