catgets
pobranie komunikatu z katalogu komunikatów
1. catgets.3.man
Manpage of CATGETS
CATGETS
Section: C Library Functions (3)Updated: 1998-08-09
Index Return to Main Contents
NAZWA
catgets - pobranie komunikatu z katalogu komunikatówSKŁADNIA
#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 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.2ZOBACZ TAKŻE
catopen(3), setlocale(3)
Index
This document was created by man2html using the manual pages.
Time: 00:24:45 GMT, November 20, 2008
