NAZWA catgets - pobranie komunikatu z katalogu komunikatów
STRESZCZENIE #include <nl_types.h>
char *catgets(nl_catd catalog, int set_number, int mes sage_number, const char *message);
OPIS Funkcja catgets() odczytuje wiadomość numer message_number w zestawie set_number z katalogu wiadomości identy fikowanego przez deskryptor catalog, zwrócony wcześniej przez catopen(). Czwarty argument message wskazuje na domyślną wiadomość, która zostanie zwrócona przez cat gets() jeśli katalog wiadomości nie jest aktualnie dostępny. Tekst wiadomości znajduje się w buforze, więc jeśli aplikacja chce go przechować lub zmodyfikować, powinna go najpierw skopiować. Zwracamy łańcuch zawsze kończy się bajtem NULL.
ZWRACANA WARTOŚĆ Jeśli funkcja catgets() zakończyła się pomyślnie, zwraca wskaźnik do obszaru bufora zawierającego łańcuch z wiadomością zakończoną bajtem NULL. Jeśli funkcja cat gets() zawiodła, zwraca wartość message.
UWAGI Funkcja ta jest dostępna jedynie w libc.so.4.4.4c i wyższych. Dokument X/Open Portability Guide ze Stycznia 1987 wyznacza inną zwracaną wartość: message jest zwracana jeśli katalog wyznaczony przez catalog jest niedostępny. Jeśli katalog jest dostępny, ale nie zawiera wskazanej wiadomości. Zasada ta nie jest to jednak stosowana w XPG4.2.