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).

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.13 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.