NOM

       catgets - Obtenir un message contenu dans un catalogue

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <nl_types.h>

       char *catgets(nl_catd catalog, int set_number, int message_number,
                     const char *message);

DESCRIPTION

       catgets()  lit  le  message numéro message_number, dans la section set_number, d'un catalogue de messages
       identifié par catalog. Ce dernier est un descripteur de  catalogue  renvoyé  par  un  appel  précédent  à
       catopen(3).  Le  quatrième  argument,  message, pointe sur une chaîne de caractères qui sera renvoyée par
       catgets() 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 ('\0').

VALEUR RENVOYÉE

       En cas de succès, catgets() renvoie un pointeur sur un tampon interne contenant le message,  terminé  par
       un caractère nul. S'il échoue, catgets() renvoie un pointeur sur l'argument message.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ Interface                                                            │ Attribut             │ Valeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ catgets()                                                            │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       POSIX.1-2001, POSIX.1-2008.

NOTES

       La  fonction  catgets()   n'est  disponible qu'à partir de libc.so.4.4.4c. Le guide « The Jan 1987 X/Open
       Portability Guide » indique un retour d'erreur plus subtil : message est renvoyé si le catalogue  indiqué
       par  l'argument  catalog  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  fa‐
       veur d'un retour constant égal à message.

VOIR AUSSI

       catopen(3), setlocale(3)

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  <tvi‐
       gnaud@mandriva.com>,  François  Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fe‐
       vrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau  <jcristau@de‐
       bian.org>,   Thomas   Huriaux   <thomas.huriaux@gmail.com>,  Nicolas  François  <nicolas.francois@centra‐
       liens.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-pierre‐
       giraud@neuf.fr>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à  de‐
       bian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.03                    5 février 2023                                       catgets(3)