Section: Manual del Programador de Linux (3)
Updated: 9 Agosto 1998
Index Return to Main
Contents
catgets - obtiene un mensaje de un catálogo
#include <nl_types.h>
char *catgets(nl_catd catalog, int set_number, int message_number, const char *message);
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.
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.
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.
(3), setlocale(3)
This document was created by man2html, using
the manual pages.
Time: 06:16:27 GMT, January 22, 2005