НАИМЕНОВАНИЕ¶

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

БИБЛИОТЕКА¶

Стандартная библиотека языка C (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).

СТАНДАРТЫ¶

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 <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.