.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 Mitchum DSouza .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Updated, aeb, 980809 .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH catgets 3 "15 juin 2024" "Pages du manuel de Linux 6.9.1" .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 \fP .P \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() 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]\[rs]0\[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 .SH STANDARDS POSIX.1\-2008. .SH HISTORIQUE POSIX.1\-2001. .P La fonction \fBcatgets\fP() n'est disponible qu'à partir de libc.so.4.4.4c. .P 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 , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Pierre Giraud . .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 .