Linux Certif

Toute la documentation sur la certification Linux LPI

catgets

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 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 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 octet nul.

VALEUR RENVOYÉE

S'il réussit, catgets() renvoie un pointeur sur un tampon interne contenant le message, terminé par un octet 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 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 SUSv2 en faveur d'un retour constant de message.

VOIR AUSSI

catopen(3), setlocale(3)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 22 octobre 1996 et révisée le 22 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 catgets ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.