.\" -*- 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 juillet 2023" "Pages du manuel de Linux 6.05.01" 
.SH NOM
catgets \- Obtenir un message contenu dans un catalogue
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP)
.SH SYNOPSIS
.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 DESCRIPTION
\fBcatgets\fP() lit le message numéro \fImessage_number\fP, dans la section
\fIset_number\fP, d'un catalogue de messages identifié par \fIcatalog\fP. Ce
dernier est un descripteur de catalogue renvoyé par un appel précédent à
\fBcatopen\fP(3). Le quatrième argument, \fImessage\fP, pointe sur une chaîne de
caractères qui sera renvoyée par \fBcatgets\fP() si le catalogue indiqué n'est
pas accessible. Le texte du message renvoyé est contenu dans un tampon
interne, et doit être recopié par l'application si l'on désire le modifier
ou le sauvegarder. La chaîne renvoyée se termine toujours par un caractère
nul (\[aq]\e0\[aq]).
.SH "VALEUR RENVOYÉE"
En cas de succès, \fBcatgets\fP() renvoie un pointeur sur un tampon interne
contenant le message, terminé par un caractère nul. S'il échoue,
\fBcatgets\fP() renvoie un pointeur sur l'argument \fImessage\fP.
.SH ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribut	Valeur
T{
.na
.nh
\fBcatgets\fP()
T}	Sécurité des threads	MT\-Safe
.TE
.sp 1
.SH STANDARDS
POSIX.1\-2008.
.SH HISTORIQUE
POSIX.1\-2001.
.PP
La fonction \fBcatgets\fP()  n'est disponible qu'à partir de libc.so.4.4.4c.
.PP
Le guide «\ The Jan 1987 X/Open Portability Guide\ » indique un retour
d'erreur plus subtil\ : \fImessage\fP est renvoyé si le catalogue indiqué par
l'argument \fIcatalog\fP n'est pas disponible, et une chaîne vide si le
catalogue est disponible mais ne contient pas le message demandé. Les deux
retours d'erreurs semblent avoir été éliminés de SUSv2 en faveur d'un retour
constant égal à \fImessage\fP.
.SH "VOIR AUSSI"
\fBcatopen\fP(3), \fBsetlocale\fP(3)
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Christophe Blaess <https://www.blaess.fr/christophe/>,
Stéphan Rafin <stephan.rafin@laposte.net>,
Thierry Vignaud <tvignaud@mandriva.com>,
François Micaux,
Alain Portal <aportal@univ-montp2.fr>,
Jean-Philippe Guérard <fevrier@tigreraye.org>,
Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>,
Julien Cristau <jcristau@debian.org>,
Thomas Huriaux <thomas.huriaux@gmail.com>,
Nicolas François <nicolas.francois@centraliens.net>,
Florentin Duneau <fduneau@gmail.com>,
Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,
Denis Barbier <barbier@debian.org>,
David Prévot <david@tilapin.org>
et
Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .