Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       iconv_open  -  Allouer  un  descripteur  pour une conversion de jeux de
       caracteres

SYNOPSIS

       #include <iconv.h>

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

DESCRIPTION

       La fonction iconv_open() alloue un descripteur de conversion  adapte  a
       la   transformation   d'une  sequence  d'octets  depuis  le  codage  de
       caracteres fromcode dans le codage tocode.

       Les valeurs autorisees pour fromcode et tocode  et  leurs  combinaisons
       acceptees dependent du systeme. Pour la bibliotheque C GNU, les valeurs
       permises sont fournies par la  commande  iconv  --list  et  toutes  les
       combinaisons de ces valeurs sont supportees. De plus, la bibliotheque C
       et la bibliotheque libiconv de GNU supportent les suffixes suivants :

       //TRANSLIT
              Quand la chaine << //TRANSLIT >> est ajoutee a la fin de tocode,
              les  translitterations sont activees. Ceci signifie que quand un
              caractere ne peut pas etre represente dans le jeu de  caracteres
              cible,  il  peut  etre  approxime  en  un des caracteres qui lui
              ressemblent.

       //IGNORE
              Quand la chaine << //IGNORE >> est ajoutee a la fin  de  tocode,
              les  caracteres  qui ne peuvent pas etre representes dans le jeu
              de caracteres cible sont simplement ignores.

       Le descripteur de conversion resultant peut etre utilise autant de fois
       que  voulu  avec  iconv(3).  Il reste valide jusqu'a sa liberation avec
       iconv_close(3).

       Un descripteur de conversion contient un etat de conversion. Lors de sa
       creation   avec   iconv_open(),  il  se  trouve  dans  l'etat  initial.
       L'utilisation de iconv(3) modifie l'etat du  descripteur.  On  ne  doit
       donc  pas  utiliser  simultanement  un  descripteur  de conversion dans
       plusieurs  << threads >>.  Pour  revenir  a  l'etat  initial,  utilisez
       iconv(3) avec un argument inbuf NULL.

VALEUR RENVOY'EE

       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 presenter :

       EINVAL La conversion depuis fromcode vers tocode  n'est  pas  supportee
              par l'implementation.

VERSIONS

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

CONFORMIT'E

       UNIX98, POSIX.1-2001.

VOIR AUSSI

       iconv(1), iconv(3), iconv_close(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                              11 aout 2008                    ICONV_OPEN(3)