Provided by: manpages-fr_1.67.0-1_all bug

NOM

       catgets - Obtenir un message contenu dans un catalogue.

SYNOPSIS

       #include <nl_types.h>

       char  *catgets  (nlcatd  catalog,  int set_number , int message_number,
       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 qui doit avoir  été  renvoyé  par  un  appel
       précédent  à catopen(3).  Le quatrième argument, message pointe sur une
       chaîne de caractères par défaut qui sera renvoyée par catgets()  si  le
       catalogue  indiqué  n’est  pas accessible.  Le texte du message renvoyé
       est contenu dans une zone de buffer interne, et doit être  recopié  par
       l’application si l’on désire le modifier, ou le sauvegarder.  La chaine
       renvoyée se termine toujours par un caractère nul.

VALEUR RENVOYÉE

       S’il réussit, catgets() renvoie  un  pointeur  sur  un  buffer  interne
       contenant  le  message,  terminé  par  un  caractère nul.  S’il échoue,
       catgets() renvoie un pointeur sur l’argument message.

NOTES

       Ces fonctions ne sont disponibles qu’à partir de la version  4.4.4c  de
       libc.so.   Le  Guide  de  Portabilité X/Open de Janvier 1987 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 XPG4.2 en
       faveur d’un retour constant de message.

CONFORMITÉ

       XPG4.2

VOIR AUSSI

       catopen(3), setlocale(3)

TRADUCTION

       Christophe Blaess, 1996-2003.