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)