Provided by: manpages-fr-dev_3.57d1p1-1_all bug

NOM
       iconv_open - Allouer un descripteur pour une conversion de jeux de caractères


SYNOPSIS
       #include <iconv.h>

       iconv_t iconv_open(const char *tocode, const char *fromcode);


DESCRIPTION
       La  fonction  iconv_open()  alloue un descripteur de conversion adapté à la transformation
       d'une séquence d'octets depuis le codage de caractères fromcode dans le codage tocode.

       Les valeurs autorisées pour fromcode et tocode et leurs combinaisons  acceptées  dépendent
       du système. Pour la bibliothèque C GNU, les valeurs permises sont fournies par la commande
       iconv --list et toutes les combinaisons de  ces  valeurs  sont  supportées.  De  plus,  la
       bibliothèque C et la bibliothèque libiconv de GNU supportent les suffixes suivants :

       //TRANSLIT
              Quand   la   chaîne   « //TRANSLIT »   est   ajoutée   à  la  fin  de  tocode,  les
              translittérations sont activées. Cela signifie que quand un caractère ne  peut  pas
              être  représenté  dans le jeu de caractères cible, il peut être approximé en un des
              caractères qui lui ressemblent.

       //IGNORE
              Quand la chaîne « //IGNORE » est ajoutée à la fin de tocode, les caractères qui  ne
              peuvent  pas  être  représentés  dans  le  jeu  de caractères cible sont simplement
              ignorés.

       Le descripteur de conversion résultant peut être utilisé autant de  fois  que  voulu  avec
       iconv(3). Il reste valide jusqu'à sa libération avec iconv_close(3).

       Un  descripteur  de  conversion  contient  un état de conversion. Lors de sa création avec
       iconv_open(), il se trouve dans l'état initial. L'utilisation de iconv(3)  modifie  l'état
       du  descripteur.  On  ne doit donc pas utiliser simultanément un descripteur de conversion
       dans plusieurs « threads ». Pour revenir à  l'état  initial,  utilisez  iconv(3)  avec  un
       argument inbuf NULL.


VALEUR RENVOYÉE
       La  fonction  iconv_open()  renvoie un nouveau descripteur de conversion. En cas d'erreur,
       elle remplit errno et renvoie (iconv_t) -1.


ERREURS
       Les erreurs suivantes peuvent, entre autres, se présenter :

       EINVAL La conversion depuis fromcode vers tocode n'est pas supportée par l'implémentation.


VERSIONS
       Cette fonction est disponible dans la glibc depuis la version 2.1.


CONFORMITÉ
       UNIX98, POSIX.1-2001.


VOIR AUSSI
       iconv(1), iconv(3), iconv_close(3)


COLOPHON
       Cette page fait partie de la publication 3.57 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.


TRADUCTION
       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Florentin  Duneau  et  l'équipe francophone de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».