Provided by:
manpages-pl-dev_20060617-3_all 
NAZWA
catgets - pobranie komunikatu z katalogu komunikatow
SK/LADNIA
#include <nl_types.h>
char *catgets(nl_catd katalog, int numer_zestawu, int numer_komunikatu,
const char *komunikat);
OPIS
Funkcja catgets() odczytuje komunikat o numerze numer_komunikatu z
zestawu numer_zestawu z katalogu komunikatow identyfikowanego przez
deskryptor katalog, zwrocony wczeniej przez catopen(3). Czwarty
argument komunikat wskazuje na domylny komunikat, ktory zostanie
zwrocony przez catgets(), jeli katalog komunikatow nie jest aktualnie
dostpny. Tekst komunikatu znajduje si w wewntrznym buforze, wic jeli
aplikacja chce go przechowa lub zmodyfikowa, powinna go najpierw
skopiowa. Zwracamy lacuch zawsze koczy si bajtem NUL.
WARTO ZWRACANA
Jeli funkcja catgets() zakoczy si pomylnie, zwraca wskanik do obszaru
bufora zawierajcego lacuch z komunikatem zakoczonym bajtem NUL. Jeli
funkcja catgets() zawiedzie, zwraca warto komunikat.
UWAGI
Funkcja ta jest dostpna jedynie w libc.so.4.4.4c i wyszych. Dokument
X/Open Portability Guide ze stycznia 1987 okrela bardziej wyrafinowany
sposob zwracania wartoci w razie wystpienia bldu: komunikat jest
zwracany, jeli katalog wyznaczony przez katalog jest niedostpny.
Natomiast gdy katalog jest dostpny, ale nie zawiera wskazanego
komunikatu, zwracany jest pusty lacuch. Zasada zwracania dwoch ronych
wartoci w przypadkach bldow zostala jednak porzucona w XPG4.2 na rzecz
zwracania zawsze wartoci komunikat.
ZGODNE Z
XPG4.2
ZOBACZ TAKE
catopen(3), setlocale(3)
INFORMACJE O T/LUMACZENIU
Powysze tlumaczenie pochodzi z nieistniejcego ju Projektu Tlumaczenia
Manuali i moe nie by aktualne. W razie zauwaenia ronic midzy powyszym
opisem a rzeczywistym zachowaniem opisywanego programu lub funkcji,
prosimy o zapoznanie si z oryginaln (angielsk) wersj strony podrcznika.
1998-08-09 CATGETS(3)