CATGETS(3)

NOMBRE
catgets - obtiene un mensaje de un catálogo

SINOPSIS

#include <features.h>
#include <nl_types.h>

char *catgets(catalog, set_number, message_number, message)
nl_catd catalog;
int set_number;
int message_number;
char *message;

DESCRIPCION

catgets() lee el mensaje message_number, asignado en set_number, del catálogo de mensajes identificado por catalog. catalog es un descriptor de catálogo retornado por una llamada anterior a catopen(3). El cuarto argumento message apunta al mensaje por defecto que puede ser retornado por catgets() si el catálogo de mensajes identificado no está actualmente abierto, o está dañado. El mensaje de texto está contenido en un acumulador (buffer) interno y debe ser copiado a la aplicación si este será salvado o modificado. La cadena de retorno es siempre terminada con un byte NULL.

VALOR RETORNADOS

Si es exitosa, catgets() retorna un puntero a un acumulador (buffer) interno conteniendo la cadena del mensaje terminada en NULL. catgets() retorna un puntero a message si este falla porque el catálogo de mensajes especificado por catalog no está abierto. De otra manera, catgets() retorna un puntero a una cadena vacía si el catálogo de mensajes está disponible pero no contiene el mensaje especificado.

NOTAS
Estas funciones son solo disponibles en libc.so.4.4.4c (o superior).

VER TAMBIEN
catopen(3), setlocale(3)