catopen(3) Library Functions Manual catopen(3) NOM catopen, catclose - Ouverture et fermeture d'un catalogue de messages BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include nl_catd catopen(const char *name, int flag); int catclose(nl_catd catalog); DESCRIPTION La fonction catopen() ouvre un catalogue de messages, et en retourne un descripteur. Celui-ci reste valide jusqu'a un appel catclose() ou execve(2). Si un descripteur de fichier est utilise pour implementer le descripteur de catalogue, le drapeau FD_CLOEXEC sera defini. L'argument name indique le nom du catalogue a ouvrir. Si name indique un chemin d'acces absolu (contenant un << / >> ) alors il est employe comme chemin d'acces au catalogue. Sinon, la variable d'environnement NLSPATH est utilisee, apres avoir substitue name a son argument %N (consultez locale(7)). Lorsque le processus a des privileges root, l'emploi eventuel de NLSPATH n'est pas garanti. Si NLSPATH n'est pas definie dans l'environnement, ou si le catalogue de messages ne peut etre ouvert dans aucun des chemins qu'elle contient, alors un chemin predefini, dependant de l'implementation, est utilise. Ce dernier peut dependre de la categorie de localisation LC_MESSAGES si l'argument flag vaut NL_CAT_LOCALE ou de la variable d'environnement LANG si l'argument flag vaut zero. Changer la partie LC_MESSAGES de la localisation, peut rendre invalides les descripteurs de catalogues deja ouverts. L'argument flag de catopen() indique l'origine du langage a utiliser. S'il vaut NL_CAT_LOCALE alors il utilisera la configuration actuelle de la localisation definie par LC_MESSAGES. Sinon, il utilisera la variable d'environnement LANG. La fonction catclose() ferme le catalogue identifie par catalog. Ceci invalide toute reference ulterieure au catalogue de message defini par le descripteur catalog. VALEUR RENVOYEE La fonction catopen() renvoie un descripteur de catalogue de messages du type nl_catd si elle reussit. En cas d'echec, elle renvoie (nl_catd) -1 et definit errno avec le code d'erreur. Les erreurs possibles incluent toutes celles que peut renvoyer l'appel open(2). La fonction catclose() renvoie 0 si elle reussit, ou -1 en cas d'echec. ENVIRONNEMENT LC_MESSAGES Peut-etre la source de la definition de la localisation LC_MESSAGES et peut servir a determiner le langage a utiliser, si flag vaut NL_CAT_LOCALE. LANG Le langage a utiliser, si flag vaut zero. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +-----------------------------+--------------------------+-------------+ |Interface | Attribut | Valeur | +-----------------------------+--------------------------+-------------+ |catopen() | Securite des threads | MT-Safe env | +-----------------------------+--------------------------+-------------+ |catclose() | Securite des threads | MT-Safe | +-----------------------------+--------------------------+-------------+ VERSIONS Tout ceci correspond a la description POSIX.1. La valeur de NL_CAT_LOCALE de la glibc est 1. Le chemin par defaut varie, mais il inclut en general plusieurs emplacements sous /usr/share/locale. STANDARDS POSIX.1-2008. HISTORIQUE POSIX.1-2001. VOIR AUSSI catgets(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.8 2 mai 2024 catopen(3)