LinuxDoc.Rucatgets - получает сообщения из каталога сообщений
НАЗВАНИЕcatgets - получает сообщения из каталога сообщений
СИНТАКСИС
#include
char *catgets(nl_catd catalog, int set_number, int mes-
sage_number, const char *message);
ОПИСАНИЕ
Функция catgets() читает сообщение номер message_number в
наборе номеров set_number, из каталога сообщений,
обозначенного как catalog, где catalog - это описатель
каталога, возвращаемый функцией catopen(3). Четвертый
аргумент, message , является указателем на строку с
сообщением по умолчанию, которое вернет catgets() в
случае, если указанный каталог сообщений недоступен.
Текст сообщений хранится во внутреннем буфере и должен
быть скопирован приложением, если оно будет изменено или
сохранено. Возвращаемая строка всегда заканчивается
нулевым байтом.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
В случае успеха catgets() возвращает указатель на буфер,
содержащий заканчивающуюся нулем строку с сообщением. Если
сообщение не найдено, то catgets() возвращает значение
message.
ЗАМЕЧАНИЯ
Эта функция доступна только в libc.so.4.4.4c и более
поздних ее версий. X/Open Portability Guide определяет
более точные собщения об ошибках: message возвращается,
если каталог catalog недоступен; а если возвращена пустая
строка, то каталог доступен, но не содержит данных о mes-
sage. Эти две возможные ситуации, похоже, не учтены в
XPG4.2, и в случае ощибки всегда возвращается message.
СООТВЕТСТВИЕ СТАНДАРТАМ
XPG4.2