NAZWA

       catgets - pobranie komunikatu z katalogu komunikatów

SKŁADNIA

       #include <nl_types.h>

       char *catgets(nl_catd katalog, int numer_zbioru, int numer_komunikatu,
                     const char *komunikat);

OPIS

       Funkcja catgets() odczytuje komunikat o numerze numer_komunikatu z zestawu numer_zestawu z
       katalogu komunikatów identyfikowanego przez deskryptor katalog, zwrócony  wcześniej  przez
       catopen(3).  Czwarty  argument  komunikat  wskazuje  na domyślny komunikat, który zostanie
       zwrócony przez catgets(), jeśli katalog  komunikatów  nie  jest  obecnie  dostępny.  Tekst
       komunikatu znajduje się w wewnętrznym buforze, więc jeśli aplikacja chce go przechować lub
       zmodyfikować, powinna go najpierw skopiować. Zwracamy łańcuch  zawsze  kończy  się  bajtem
       null ("\0").

WARTOŚĆ ZWRACANA

       Jeśli  funkcja  catgets()  zakończy  się  pomyślnie,  zwraca  wskaźnik  do  obszaru bufora
       zawierającego łańcuch z komunikatem  zakończonym  bajtem  null.  Jeśli  funkcja  catgets()
       zawiedzie, zwraca wartość komunikat.

ATRYBUTY

   Wielowątkowość (patrz pthreads(7))
       Funkcja catgets() jest wątkowo bezpieczna.

ZGODNE Z

       POSIX.1-2001.

UWAGI

       Funkcja  catgets()  jest  dostępna  jedynie  w  libc.so.4.4.4c i wyższych. Dokument X/Open
       Portability Guide ze stycznia 1987 określa bardziej wyrafinowany sposób zwracania wartości
       w razie wystąpienia błędu: komunikat jest zwracany, jeśli katalog wyznaczony przez katalog
       jest niedostępny.  Natomiast  gdy  katalog  jest  dostępny,  ale  nie  zawiera  wskazanego
       komunikatu,  zwracany  jest  pusty  łańcuch.   Zasada  zwracania  dwóch różnych wartości w
       przypadkach błędów została jednak porzucona w SUSv2 na  rzecz  zwracania  zawsze  wartości
       komunikat.

ZOBACZ TAKŻE

       catopen(3), setlocale(3)

O STRONIE

       Angielska  wersja  tej  strony  pochodzi  z  wydania  3.71  projektu Linux man-pages. Opis
       projektu, informacje dotyczące zgłaszania błędów, oraz najnowszą  wersję  oryginału  można
       znaleźć pod adresem http://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami  polskiego  tłumaczenia  niniejszej  strony podręcznika man są: Adam Byrtek (PTM)
       <abyrtek@priv.onet.pl>, Andrzej Krzysztofowicz (PTM) <ankry@mif.pg.gda.pl>, Robert Luberda
       <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>.

       Polskie  tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na
       stronie  http://sourceforge.net/projects/manpages-pl/.  Jest   zgodne   z   wersją    3.71
       oryginału.

                                            2014-06-13                                 CATGETS(3)