catgets(3) 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.

OBSERVACIONES

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