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

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.

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.

POSIX.1-2001.

catopen(3), setlocale(3)

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 14 août 2006.

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.