Rechercher une page de manuel
catgets
Langue: pl
Version: 1998-08-09 (openSuse - 09/10/07)
Section: 3 (Bibliothèques de fonctions)
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)Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre