Provided by: manpages-es_1.55-3_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)