NAZWA

       catgets - pobiera komunikat z katalogu komunikatów

BIBLIOTEKA

       Standardowa biblioteka C (libc, -lc)

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-bezpieczne │
       └──────────────────────────────────────────────────────────────┴────────────────────────┴───────────────┘

STANDARDY

       POSIX.1-2008.

HISTORIA

       POSIX.1-2001.

       Funkcja catgets() jest dostępna tylko 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)

TŁUMACZENIE

       Tłumaczenie   niniejszej   strony   podręcznika:   Adam  Byrtek  <alpha@irc.pl>,  Andrzej  Krzysztofowicz
       <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

       Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje  o  warunkach  licencji  można  uzyskać
       zapoznając   się   z   GNU General Public License w wersji 3   lub  nowszej.  Nie  przyjmuje  się  ŻADNEJ
       ODPOWIEDZIALNOŚCI.

       Błędy w  tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej  manpages-pl-
       list@lists.sourceforge.net.

Linux man-pages 6.9.1                          15 czerwca 2024 r.                                     catgets(3)