CATGETS(3)

NOME
catgets - obtem mensagem de um catálogo de mensagens

SINÓPSE

#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, onde catalog é um descritor de catálogo retornado por uma chamada anterior a catopen(3). O argumento message aponta para uma mensagem padrão que será retornada por catgets() 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 NULO.

VALORES RETORNADOS

Se tiver êxito, catgets() retorna um ponteiro para um 'buffer' interno contendo o texto da mensagem. Se falhar, catgets() retorna o valor de message.

NOTAS
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 especificado por catalog não estiver disponível, e uma seqüencia 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.

VEJA TAMBÉM
catopen(3), setlocale(3).

TRADUZIDO POR LDP-BR em 21/08/2000.

  Tradução:
Paulo César Mendes <drpc@ism.com.br>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>