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.
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.
XPG4.2
VÉASE TAMBIÉN¶
catopen(3),
setlocale(3)