char *catgets(nl_catd catalog, int set_number,int message_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
недоступен; а если возвращена пустая строка, то каталог доступен,
но не содержит данных о
message.
Эти две возможные ситуации, похоже, не учтены в XPG4.2, и
в случае ощибки всегда возвращается
message.
