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 ('\0')..

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.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
       ┌───────────┬────────────────────┬───────────────────┐
       │ Interfaz  │ Atributo           │ Valor             │
       ├───────────┼────────────────────┼───────────────────┤
       │ catgets() │ Seguridad del hilo │ Multi-hilo seguro │
       └───────────┴────────────────────┴───────────────────┘

CONFORME A

       POSIX.1-2001, POSIX.1-2008.

NOTAS

       The  catgets()   function is available only in libc.so.4.4.4c and above.  The Jan 1987 X/Open Portability
       Guide specifies a more subtle error return: message is returned  if  the  message  catalog  specified  by
       catalog  is  not  available,  while an empty string is returned when the message catalog is available but
       does not contain the specified message.  These two possible error returns seem to be discarded  in  SUSv2
       in favor of always returning message.

VÉASE TAMBIÉN

       catopen(3), setlocale(3)

COLOFÓN

       Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del
       proyecto,   información   sobre   cómo   informar   errores  y  la  última  versión  de  esta  página  en
       https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN

       La  traducción  al  español  de  esta   página   del   manual   fue   creada   por   Sebastian   Desimone
       <chipy@argenet.com.ar>,   Gerardo   Aburruzaga   García   <gerardo.aburruzaga@uca.es>   y   Juan  Piernas
       <piernas@ditec.um.es>

       Esta traducción es documentación libre;  lea  la  GNU General Public License Version 3  o  posterior  con
       respecto a las condiciones de copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si  encuentra  algún  error  en  la  traducción  de esta página del manual, envíe un correo electrónico a
       debian-l10n-spanish@lists.debian.org.

                                                  6 Marzo 2019                                        CATGETS(3)