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() le a mensagem de numero message_number, no conjunto
       set_number do catalogo designado por catalog, onde catalog e um
       descritor de catalogo retornado por uma chamada anterior a catopen(3).
       O argumento message aponta para uma mensagem padrao que sera retornada
       por catgets() indica uma mensagem padrao a ser retornada se o catalogo
       nao estiver disponivel. O texto fica num 'buffer' interno, e deve ser
       copiado pelo aplicativo se se desejar grava-lo ou modifica-lo. A string
       retornada e sempre terminada em NULO ('\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.06            31 outubro 2023                     catgets(3)