.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 Mitchum DSouza <m.dsouza@mrc-applied-psychology.cambridge.ac.uk>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" Updated, aeb, 980809
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH catgets 3 "20 ​​Julio 2023" "Páginas de manual de Linux 6.05.01" 
.SH NOMBRE
catgets \- obtiene un mensaje de un catálogo
.SH BIBLIOTECA
Biblioteca Estándar C (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSIS
.nf
\fB#include <nl_types.h>\fP
.PP
\fBchar *catgets(nl_catd \fP\fIcatalog\fP\fB, int \fP\fIset_number\fP\fB, int \fP\fImessage_number\fP\fB,\fP
\fB              const char *\fP\fImessage\fP\fB);\fP
.fi
.SH DESCRIPCIÓN
\fBcatgets\fP()  reads the message \fImessage_number\fP, in set \fIset_number\fP,
from the message catalog identified by \fIcatalog\fP, where \fIcatalog\fP is a
catalog descriptor returned from an earlier call to \fBcatopen\fP(3).  The
fourth argument, \fImessage\fP, points to a default message string which will
be returned by \fBcatgets\fP()  if the identified message catalog is not
currently available.  The message\-text is contained in an internal buffer
area and should be copied by the application if it is to be saved or
modified.  The return string is always terminated with a null byte
(\[aq]\e0\[aq]).
.SH "VALOR DEVUELTO"
Si tiene éxito, \fBcatgets\fP() devuelve un puntero a un área de memoria
interna conteniendo la cadena del mensaje terminada en NUL. \fBcatgets\fP()
devuelve un puntero a \fImessage\fP.
.SH ATRIBUTOS
Para obtener una explicación de los términos usados en esta sección, véase
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interfaz	Atributo	Valor
T{
.na
.nh
\fBcatgets\fP()
T}	Seguridad del hilo	Multi\-hilo seguro
.TE
.sp 1
.SH ESTÁNDARES
POSIX.1\-2008.
.SH HISTORIAL
POSIX.1\-2001.
.PP
The \fBcatgets\fP()  function is available only in libc.so.4.4.4c and above.
.PP
The Jan 1987 X/Open Portability Guide specifies a more subtle error return:
\fImessage\fP is returned if the message catalog specified by \fIcatalog\fP 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
\fImessage\fP.
.SH "VÉASE TAMBIÉN"
\fBcatopen\fP(3), \fBsetlocale\fP(3)
.PP
.SH 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>
.
.PP
Esta traducción es documentación libre; lea la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
o posterior con respecto a las condiciones de copyright.
No existe NINGUNA RESPONSABILIDAD.
.PP
Si encuentra algún error en la traducción de esta página del manual, envíe un
correo electrónico a
.MT debian-l10n-spanish@lists.debian.org
.ME .