catgets(3) Library Functions Manual catgets(3) NOM catgets - Obtenir un message contenu dans un catalogue BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include char *catgets(nl_catd catalog, int set_number, int message_number, const 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 de catalogue renvoye par un appel precedent a catopen(3). Le quatrieme argument, message, pointe sur une chaine de caracteres qui sera renvoyee par catgets() si le catalogue indique n'est pas accessible. Le texte du message renvoye est contenu dans un tampon 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 ('\0'). VALEUR RENVOYEE En cas de succes, catgets() renvoie un pointeur sur un tampon interne contenant le message, termine par un caractere nul. S'il echoue, catgets() renvoie un pointeur sur l'argument message. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +---------------------------------+--------------------------+---------+ |Interface | Attribut | Valeur | +---------------------------------+--------------------------+---------+ |catgets() | Securite des threads | MT-Safe | +---------------------------------+--------------------------+---------+ STANDARDS POSIX.1-2008. HISTORIQUE POSIX.1-2001. La fonction catgets() n'est disponible qu'a partir de libc.so.4.4.4c. Le guide << The Jan 1987 X/Open Portability Guide >> indique un retour d'erreur plus subtil : message est renvoye si le catalogue indique par l'argument catalog n'est pas disponible, et une chaine vide si le catalogue est disponible mais ne contient pas le message demande. Les deux retours d'erreurs semblent avoir ete elimines de SUSv2 en faveur d'un retour constant egal a message. VOIR AUSSI catopen(3), setlocale(3) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Jean-Pierre Giraud Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 catgets(3)