CATGETS

Section: Manual del Programador de Linux (3)
Updated: 9 Agosto 1998
Index Return to Main Contents


 

NOMBRE

catgets - obtiene un mensaje de un catálogo  

SINOPSIS

#include <nl_types.h>

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

DESCRIPCIÓN

catgets() lee el mensaje message_number, en el conjunto set_number, del catálogo de mensajes identificado por catalog, donde catalog es un descriptor de catálogo devuelto por una llamada anterior a catopen(3). El cuarto argumento, message, apunta a un mensaje predeterminado que será devuelto por catgets() si el catálogo de mensajes identificado no está actualmente disponible. El texto del mensaje está contenido en un área de memoria interna y debe ser copiado a la aplicación si se quiere guardar o modificar. La cadena devuelta siempre se hace terminar con un byte NUL.  

VALOR DEVUELTO

Si tiene éxito, catgets() devuelve un puntero a un área de memoria interna conteniendo la cadena del mensaje terminada en NUL. catgets() devuelve un puntero a message.  

NOTAS

Estas funciones están disponibles solamente en libc.so.4.4.4c o superior. The X/Open Portability Guide de enero de 1987 especifica un caso de error más sutil: se devuelve message si no está disponible el catálogo de mensajes especificado por catalog, mientras que se devuelve una cada vacía cuando está disponible el catálogo de mensajes pero no contiene el mensaje indicado. Parece ser que estos dos casos posibles de error se van a eliminar de XPG4.2 en favor de que siempre se devuelva message.  

CONFORME A

XPG4.2  

VÉASE TAMBIÉN

catopen

(3), setlocale(3)


 

Index

NOMBRE
SINOPSIS
DESCRIPCIÓN
VALOR DEVUELTO
NOTAS
CONFORME A
VÉASE TAMBIÉN

This document was created by man2html, using the manual pages.
Time: 06:16:27 GMT, January 22, 2005