Manpages

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 [AT] ism.br> (tradução) xxxxxxxxxxxxxxxxxxxxxxxxx <xxx [AT] xxxxxx.xx> (revisão)