Provided by: manpages-pl-dev_0.7-1_all 
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)