Provided by: manpages-fr-dev_2.80.1-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  translitérations  sont activées. Ceci 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ère qui lui
              ressemble.

       //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 resultant 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.

CONFORMITÉ

       UNIX98, POSIX.1-2001.

VOIR AUSSI

       iconv(1), iconv(3), iconv_close(3)

COLOPHON

       Cette  page  fait  partie  de  la  publication 2.80 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

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
       francophone de traduction de Debian.

       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> ».