CATGETS(3)         Manuel du programmeur Linux         CATGETS(3)


NOM
       catgets - Obtenir un message contenu dans un catalogue.

SYNOPSIS
       #include <features.h>

       #include <nl_types.h>

       char  *catgets  (nlcatd catalog, int set_number , int mes­
       sage_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 qua­
       trième argument, message pointe sur  une  chaîne  de  car­
       actè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  parce  catalog n'est pas ouvert, cat­
       gets() renvoie un pointeur sur l'argument message.  Si  le
       message  n'existe pas dans le catalogue indiqué, catgets()
       renvoie une chaîne vide.

NOTES
       Ces fonctions ne sont disponibles qu'à partir de  la  ver­
       sion 4.4.4c de libc.so.

VOIR AUSSI
       catopen(3), setlocale(3)


TRADUCTION
       Christophe Blaess, 1997.












Linux                    22 Octobre 1996                        1