catopen   Début   Suivant   Sommaire   Préc.page.lue   Accueil
Section: Manuel du programmeur Linux (3)
Updated: 14 décembre 2001
Sommaire  



NOM   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
catopen, catclose - Ouverture/fermeture d'un catalogue de messages  



SYNOPSIS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
#include <nl_types.h>

nl_catd catopen (char *name, int flag);

int catclose (nl_catd catalog);  




DESCRIPTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
La fonction catopen() ouvre un catalogue de message, et en retourne un descripteur. Celui-ci reste valide jusqu'à un appel catclose() ou execve(2). Si un descripteur de fichier est utilisé pour implémenter le descripteur de catalogue, il disposera de l'attribut FD_CLOEXEC.

L'argument name indique le nom du catalogue à ouvrir. Si name indique un chemin d'accès absolu (contenant un « / » ) alors il est employé comme chemin d'accès au catalogue. Sinon, la variable d'environnement NLSPATH est utilisée, après avoir substitué name à son argument %N (voir locale(7)). Lorsque le processus à des privilèges root, l'emploi éventuel de NLSPATH n'est pas garanti. Si NLSPATH n'est pas définie dans l'environnement, ou si le catalogue de messages ne peut être ouvert dans aucun des chemins qu'elle contient, alors un chemin prédéfini, dépendant de l'implémentation, est utilisé. Ce dernier peut dépendre de la catégorie de localisation LC_MESSAGES si l'argument flag vaut NL_CAT_LOCALE ou de la variable d'environnement LANG si l'argument flag vaut zéro. Changer la partie LC_MESSAGES de la localisation, peut rendre invalides les descripteurs de catalogues déjà ouverts.

L'argument flag de catopen() indique l'origine du langage à utiliser. S'il vaut NL_CAT_LOCALE alors il utilisera la configuration de la localisation pour LC_MESSAGES. Sinon, il utilisera la variable d'environnement LANG.

La fonction catclose() Ferme le catalogue identifié par catalog. Ceci invalide toute référence ultérieure au catalogue par le descripteur catalog.  




VALEUR RENVOYÉE   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
La fonction catopen() renvoie un descripteur de catalogue de messages, du type nl_catd si elle réussit. En cas d'échec, elle renvoie (nl_catd) -1 et remplit errno avec le code d'erreur. Les erreurs possibles incluent toutes celles que peut renvoyer open(2).

La fonction catclose() renvoie 0 si elle réussit, ou -1 en cas d'échec.  




ENVIRONNEMENT   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
LC_MESSAGES
Peut servir à déterminer le langage à utiliser, si flag vaut NL_CAT_LOCALE.
LANG
Le langage à utiliser, si flag vaut zéro.
 



CONFORMITÉ   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
POSIX.1-2001. L'origine des constantes MCLoadBySet et MCLoadAll est inconnue.  



NOTES   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
Tout ceci correspond à la description de POSIX.1-2001. La valeur de NL_CAT_LOCALE dans la glibc est 1. (Voir MCLoadAll plus bas). Le chemin par défaut varie, mais il inclut en général plusieurs emplacements sous /usr/share/locale.  



Notes Linux   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
Ces fonctions sont disponibles sous Linux depuis la version 4.4.4c de libc.so, et ultérieures. Dans le cas des libc4 et libc5, le descripteur de catalogue nl_catd est en réalité une zone de mémoire de projection mmap(2) et non pas un descripteur de fichier. L'argument flag de catopen() devrait être soit MCLoadBySet (= 0), soit MCLoadAll (= 1). La première valeur indique qu'un ensemble du catalogue doit être chargé quand le besoin s'en fait sentir, alors que la seconde réclame le chargement em mémoire dès l'appel catopen() initial. Le chemin par défaut varie, mais il inclut en général plusieurs emplacements sous /etc/locale et /usr/lib/locale.  



VOIR AUSSI   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
catgets(3), setlocale(3)  



TRADUCTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil

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 8 janvier 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 catopen ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.


 



Sommaire   Début   Suivant   Sommaire   Préc.page.lue   Accueil
NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ENVIRONNEMENT
CONFORMITÉ
NOTES
Notes Linux
VOIR AUSSI
TRADUCTION

Table des mots clés   Début   Suivant   Sommaire   Préc.page.lue   Accueil
LANGENVIRONNEMENT
LC_MESSAGESENVIRONNEMENT



Ce document a été créé par man2html suivi de man2html.pl, le 17/10/2008 17:55:18, en utilisant les pages de 'man'.
 

Valid HTML 4.01 Transitional