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()   reads  the  message message_number, in set set_number, from the message catalog identified by
       catalog, where catalog is a catalog descriptor returned from an earlier call to  catopen(3).  The  fourth
       argument,  message,  points  to  a  default  message  string  which will be returned by catgets()  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 ('\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-2008.

HISTORIQUE

       POSIX.1-2001.

       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 faveur 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
       <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>

       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  à
       debian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.9.1                    15 juin 2024                                        catgets(3)