NAZWA¶
catgets - pobranie komunikatu z katalogu komunikatów
SKŁADNIA¶
#include <nl_types.h>
char *catgets(nl_catd katalog, int
numer_zestawu, int numer_komunikatu, const
char *komunikat);
OPIS¶
Uwaga! To tłumaczenie może być nieaktualne!
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 aktualnie 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
NUL.
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 NUL. Jeśli funkcja
catgets()
zawiedzie, zwraca wartość
komunikat.
UWAGI¶
Funkcja ta 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 XPG4.2 na
rzecz zwracania zawsze wartości
komunikat.
ZGODNE Z¶
XPG4.2
ZOBACZ TAKŻE¶
catopen(3),
setlocale(3)
Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu
Tłumaczenia Manuali i
może nie być aktualne. W razie
zauważenia różnic między powyższym opisem a
rzeczywistym zachowaniem opisywanego programu lub funkcji, prosimy o
zapoznanie się z oryginalną (angielską) wersją strony
podręcznika za pomocą polecenia:
- man --locale=C 3 catgets
Prosimy o pomoc w aktualizacji stron man - więcej informacji można
znaleźć pod adresem
http://sourceforge.net/projects/manpages-pl/.