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.
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)
