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)