ИМЯ

       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 <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>

       Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3
       или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное  письмо
       на man-pages-ru-talks@lists.sourceforge.net.

Linux man-pages 6.03                            5 февраля 2023 г.                                     catgets(3)