Provided by: manpages-es_1.55-10_all bug

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.

CONFORME A

       XPG4.2

VÉASE TAMBIÉN

       catopen(3), setlocale(3)