catgets(3c) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

catgets(3c)

Standard C Library Functions                                       catgets(3C)



NAME
       catgets - read a program message

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 read message msg_id, in set set_id,
       from the message catalog identified by catd. The  catd  argument  is  a
       catalog  descriptor  returned  from an earlier call to catopen(). The s
       argument points to a default message string which will be  returned  by
       catgets() if the identified message catalog is not currently available.

RETURN VALUES
       If  the identified message is retrieved successfully, catgets() returns
       a pointer to an internal buffer area  containing  the  null  terminated
       message  string.  If the call is unsuccessful for any reason, catgets()
       returns a pointer to s and errno may be set to indicate the error.

ERRORS
       The catgets() function may fail if:

       EBADF      The catd argument is not a valid message catalogue  descrip‐
                  tor open for reading.


       EBADMSG    The  number  of  %n  specifiers  that  appear in the message
                  string specified by s does not match the number of %n speci‐
                  fiers  that  appear  in the message identified by set_id and
                  msg_id in the specified message catalog.


       EINTR      The read operation was terminated due to the  receipt  of  a
                  signal, and no data was transferred.


       EINVAL     The message catalog identified by catd is corrupted.


       ENOMSG     The  message  identified  by set_id and msg_id is not in the
                  message catalog.


USAGE
       The catgets() function can be used safely in multithreaded applications
       as long as setlocale(3C) is not being called to change the locale.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelMT-Safe _  Stan‐
       dardSee standards(7).


SEE ALSO
       setlocale(3C),   gencat(1),   catclose(3C),  catopen(3C),  gettext(3C),
       attributes(7), standards(7)



Oracle Solaris 11.4               17 Aug 2018                      catgets(3C)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3