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 message_number, char *message)

DESCRIPTION
catgets() lit le message numero message_number, dans la section set_number, d'un catalogue de messages identifie par catalog. Ce dernier est un descripteur qui doit avoir ete renvoye par un appel precedent a catopen(3). Le quatrieme argument, message pointe sur une chaine de caracteres par defaut qui sera renvoyee par catgets() si le catalogue indique n'est pas accessible. Le texte du message renvoye est contenu dans une zone de buffer interne, et doit etre recopie par l'application si l'on desire le modifier, ou le sauvegarder. La chaine renvoyee se termine toujours par un caractere nul.

VALEUR RENVOYEE

S'il reussit, catgets() renvoie un pointeur sur un buffer interne contenant le message, termine par un caractere nul. S'il echoue parce catalog n'est pas ouvert, catgets() renvoie un pointeur sur l'argument message. Si le message n'existe pas dans le catalogue indique, catgets() renvoie une chaine vide.

NOTES
Ces fonctions ne sont disponibles qu'a partir de la version 4.4.4c de libc.so.

VOIR AUSSI
catopen(3), setlocale(3)