Provided by: manpages-pt-dev_20040726-4_all bug

NOME

       catgets - obtem mensagem de um catálogo de mensagens

SINOPSE

       #include <nl_types.h>

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

DESCRIÇÃO

       catgets()  lê  a  mensagem  de  número  message_number,   no   conjunto
       set_number  do  catálogo  designado  por catalog, que é um descritor de
       catálogo retornado por uma chamada anterior a catopen(3).  O  argumento
       message  indica  uma  mensagem padrão a ser retornada se o catálogo não
       estiver disponível. O texto fica num buffer interno, e deve ser copiado
       pelo  aplicativo  se  se  desejar  gravá-lo  ou  modificá-lo.  A string
       retornada é sempre terminada em null.

VALOR RETORNADO

       Se tiver êxito, catgets() retorna um ponteiro para  um  buffer  interno
       contendo o texto da mensagem.  Se falhar, retorna message.

OBSERVAÇÕES

       Estas  funções  só  existem  no  libc.so.4.4.4c e posteriores. O X/Open
       Portability Guide de janeiro de 1987 define uma mensagem de  erro  mais
       sutil:  será  retornado message se o catálogo não estiver disponível, e
       uma string vazia se o catálogo estiver disponível mas  não  contiver  a
       mensagem  especificada.   Estas  dois  erros não são diferenciados pelo
       XPG4.2, que sempre retorna message.

DE ACORDO COM

       XPG4.2

VER TAMBÉM

       catopen(3), setlocale(3)

TRADUZIDO POR LDP-BR em 21/08/2000.

       Paulo       César       Mendes       <drpc@ism.com.br>       (tradução)
       xxxxxxxxxxxxxxxxxxxxxxxxx <xxx@xxxxxx.xxx.xx> (revisão)

                                 9 August 1998                      CATGETS(3)