catgets(3)                 Library Functions Manual                 catgets(3)

NOME
       catgets - get message from a message catalog

BIBLIOTECA
       Biblioteca C Padrao (libc, -lc)

SINOPSE
       #include <nl_types.h>

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

DESCRICAO
       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').

VALOR DE RETORNO
       Se tiver exito, catgets() retorna um ponteiro para um 'buffer' interno
       contendo o texto da mensagem. Se falhar, catgets() retorna o valor de
       message.

ATRIBUTOS
       Para uma explicacao dos termos usados nesta secao, consulte
       attributes(7).

       +--------------------------------------------+---------------+---------+
       |Interface                                   | Atributo      | Valor   |
       +--------------------------------------------+---------------+---------+
       |catgets()                                   | Thread safety | MT-Safe |
       +--------------------------------------------+---------------+---------+
PADROES
       POSIX.1-2008.

HISTORICO
       POSIX.1-2001.

       The catgets()  function is available only in libc.so.4.4.4c and above.

       The Jan 1987 X/Open Portability Guide specifies a more subtle error
       return: message is returned if the message catalog specified by catalog
       is not available, while an empty string is returned when the message
       catalog is available but does not contain the specified message.  These
       two possible error returns seem to be discarded in SUSv2 in favor of
       always returning message.

VEJA TAMBEM
       catopen(3), setlocale(3)

TRADUCAO
       A traducao para portugues brasileiro desta pagina man foi criada por
       Paulo Cesar Mendes <drpc@ism.com.br> e Andre Luiz Fassone
       <lonely_wolf@ig.com.br>

       Esta traducao e uma documentacao livre; leia a Licenca Publica Geral
       GNU Versao 3 <https://www.gnu.org/licenses/gpl-3.0.html> ou posterior
       para as condicoes de direitos autorais.  Nenhuma responsabilidade e
       aceita.

       Se voce encontrar algum erro na traducao desta pagina de manual, envie
       um e-mail para a lista de discussao de tradutores
       <debian-l10n-portuguese@lists.debian.org>.

Linux man-pages 6.9.1            15 junho 2024                      catgets(3)