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)