NOM

       catgets - Obtenir un message contenu dans un catalogue

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.

CONFORMITÉ

       POSIX.1-2001.

NOTES

       Ces  fonctions  ne sont disponibles qu'à partir de libc.so.4.4.4c. Le guide « The Jan 1987
       X/Open Portability Guide » indique un retour d'erreur plus subtile : 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)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Florentin  Duneau  et  l'équipe francophone de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».

                                           21 juin 2013                                CATGETS(3)