CATGETS(3)

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 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 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 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 égal à 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 17 juillet 2008.

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.