Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
catopen, catclose - Ouverture et fermeture d'un catalogue de messages
SYNOPSIS
#include <nl_types.h>
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 RENVOY'EE
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 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.
CONFORMIT'E
POSIX.1-2001. L'origine des constantes MCLoadBySet et MCLoadAll est
incertaine (consultez ci-dessous).
NOTES
Tout ceci correspond a la description POSIX.1-2001. La valeur de
NL_CAT_LOCALE de la glibc est 1 (Comparez avec MCLoadAll plus bas). Le
chemin par defaut varie, mais il inclut en general plusieurs
emplacements sous /usr/share/locale.
Notes sur Linux
Ces fonctions sont disponibles sous Linux depuis la version 4.4.4.c de
la libc. Dans le cas des libc4 et libc5 Linux, le descripteur de
catalogue nl_catd est en realite une zone de memoire de projection
mmap(2) et non pas un descripteur de fichier. L'argument flag de
catopen() devrait etre soit MCLoadBySet (= 0) soit MCLoadAll (= 1). La
premiere valeur indique qu'un ensemble du catalogue doit etre charge
quand le besoin s'en fait sentir, alors que la seconde reclame le
chargement en memoire des l'appel initial a catopen(). Le chemin par
defaut varie, mais il inclut en general plusieurs emplacements sous
/etc/locale et /usr/lib/locale.
VOIR AUSSI
catgets(3), setlocale(3)
COLOPHON
Cette page fait partie de la publication 3.27 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Florentin
Duneau et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.
GNU 14 decembre 2001 CATOPEN(3)