catgets

ИМЯ

catgets - получает сообщение из каталога сообщений

LIBRARY

Standard C library ( libc, -lc)

СИНТАКСИС

#include <nl_types.h>

char *catgets(nl_catd catalog, int set_number, int message_number,
              const char *message);

ОПИСАНИЕ

catgets() reads the message message_number, in set set_number, from the message catalog identified by catalog, where catalog is a catalog descriptor returned from an earlier call to catopen(3). The fourth argument, message, points to a default message string which will be returned by catgets() if the identified message catalog is not currently available. The message-text is contained in an internal buffer area and should be copied by the application if it is to be saved or modified. The return string is always terminated with a null byte ('\0').

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении catgets() возвращает указатель на внутренний буфер, содержащий заканчивающуюся null строку с сообщением. Если сообщение не найдено, то catgets() возвращает значение message.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс	Атрибут	Значение
catgets()	Безвредность в нитях	MT-Safe

СТАНДАРТЫ

POSIX.1-2001, POSIX.1-2008.

ЗАМЕЧАНИЯ

Функция catgets() доступна только в libc.so.4.4.4c и более поздних версиях. В январе 1987 года в X/Open Portability Guide определены более точные сообщения об ошибках: message возвращается, если каталог catalog недоступен; если возвращена пустая строка, то каталог доступен, но не содержит данных о сообщении. Эти две возможные ситуации, похоже, не учтены в XSUSv2, и в случае ошибки всегда возвращается message.

СМ. ТАКЖЕ

catopen(3), setlocale(3)

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Azamat Hackimov <[email protected]>, Dmitriy S. Seregin <[email protected]>, Dmitry Bolkhovskikh <[email protected]>, Katrin Kutepova <[email protected]>, Yuri Kozlov <[email protected]> и Иван Павлов <[email protected]> Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на [email protected]