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
TRADUZIDO POR LDP-BR em 21/08/2000.
Paulo César Mendes <drpc [AT] ism.br> (tradução) xxxxxxxxxxxxxxxxxxxxxxxxx <xxx [AT] xxxxxx.xx> (revisão)