catgets − Obtenir un message contenu dans un catalogue.

#include <nl_types.h>

char *catgets (nlcatd catalog, int set_number , int message_number, char *message)

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.

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.

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.

XPG4.2

catopen(3), setlocale(3)

Christophe Blaess, 1997.