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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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)