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)