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

       Informacje   o   pojęciach   używanych   w  tym  rozdziale  można  znaleźć  w  podręczniku
       attributes(7).

       ┌──────────┬────────────────────────┬─────────┐
       │Interfejs │ Atrybut                │ Wartość │
       ├──────────┼────────────────────────┼─────────┤
       │catgets() │ Bezpieczeństwo wątkowe │ MT-Safe │
       └──────────┴────────────────────────┴─────────┘

ZGODNE Z

       POSIX.1-2001, POSIX.1-2008.

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  4.07  projektu  Linux  man-pages.  Opis
       projektu,  informacje  dotyczące  zgłaszania  błędów oraz najnowszą wersję oryginału można
       znaleźć pod adresem https://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ą   4.07
       oryginału.

                                            2015-08-08                                 CATGETS(3)