Linux Certif

Toute la documentation sur la certification Linux LPI

catgets

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

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)