Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] catopen, catclose - Ouverture/fermeture d'un catalogue de messages. [size=18] [b]Résumé[/b] [/size] [b]#include <nl_types.h>[/b] [b][i]nl_catd catopen (char * name , int flag );[/i][/b] [b][i]int catclose (nl_catd catalog );[/i][/b] [size=18] [b]Description[/b] [/size] La fonction [b]catopen()[/b] ouvre un catalogue de message, et en retourne un descripteur. Celui-ci reste valide jusqu'à un appel catclose() ou exec(). Si un descripteur de fichier est utilisé pour implémenter le descripteur de catalogue, il disposera de l'attribut FD_CLOEXEC.     L'argument [i]name[/i] indique le nom du catalogue à ouvrir. Si [i]name[/i] 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 [b]NLSPATH[/b] est utilisée, après avoir substitué [i]name[/i] à son argument [b]%N[/b] (voir [b]locale (7)).[/b] Lorsque le processus à des privilèges root, l'emploi éventuel de [b]NLSPATH[/b] n'est pas garanti. Si [b]NLSPATH[/b] 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 [b]LC_MESSAGES[/b] si l'argument [i]flag[/i] vaut NL_CAT_LOCALE ou de la variable d'environnement [b]LANG[/b] si l'argument [i]flag[/i] vaut zéro. Changer la partie LC_MESSAGES de la localisation, peut rendre invalides les descripteurs de catalogues déjà ouverts.     L'argument [i]flag[/i] de [b]catopen()[/b] indique l'origine du langage à utiliser. S'il vaut [b]NL_CAT_LOCALE[/b] alors il utilisera la configuration de la localisation pour [b]LC_MESSAGES.[/b] Sinon, il utilisera la variable d'environnement [b]LANG .[/b]     La fonction [b]catclose()[/b] Ferme le catalogue identifié par [b]catalog .[/b] Ceci invalide toute référence ultérieure au catalogue par le descripteur [b]catalog .[/b] [size=18] [b]Valeur renvoyée[/b] [/size]     La fonction [b]catopen()[/b] renvoie un descripteur de catalogue de messages, du type [i]nl_catd[/i] si elle réussit. En cas d'échec elle renvoie (nl_catd) -1, et remplit [i]errno[/i] avec le code d'erreur. Les erreurs possibles incluent toutes celles que peut renvoyer [b]open (2).[/b]     La fonction [b]catclose()[/b] renvoie 0 si elle réussit, ou -1 en cas d'échec. [size=18] [b]Environnement[/b] [/size] [b]LC_MESSAGES[/b] [table][row][col]    [/col][col]Peut servir à déterminer le langage à utiliser, si [i]flag[/i] vaut [b]NL_CAT_LOCALE .[/b][/col][/row][/table] [b]LANG[/b] [table][row][col]    [/col][col]Le langage à utiliser, si [i]flag[/i] vaut zéro.[/col][/row][/table] [size=18] [b]Notes[/b] [/size] Tout ceci correspond à la description de POSIX 1003.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 [b]/usr/share/locale .[/b] [size=18] [b]Notes[/b] [/size] Ces fonctions sont disponibles sous Linux depuis la version 4.4.4.c de libc.so, et ultérieures. Dans le cas des libc4 et libc5, le descripteur de catalogue [i]nl_catd[/i] est en réalite une zone de mémoire de projection [b]mmap()[/b] et non pas un descripteur de fichier. L'argument [i]flag[/i] de [b]catopen()[/b] devrait être soit [b]MCLoadBySet[/b] (= 0) soit [b]MCLoadAll[/b] (= 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 [b]catopen ()[/b] initial. Le chemin par défaut varie, mais il inclut en général plusieurs emplacements sous [i]/etc/locale[/i] et [b]/usr/lib/locale .[/b] [size=18] [b]Conformité[/b] [/size] POSIX 1003.1-2001. Dans XPG 1987, Vol. 3 , il est dit : [i]L'argument flag de catopen est réservé pour un usage futur[/i] [b]et doit être mis à 0 .[/b] L'origine des constantes MCLoadBySet et MCLoadAll est inconnue. [size=18] [b]Voir aussi[/b] [/size] [b]catgets (3),[/b] [b]setlocale (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier