iconv_open(3)              Library Functions Manual              iconv_open(3)

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

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

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 prises en charge. De plus, la
       bibliotheque C et la bibliotheque libiconv de GNU prennent en charge
       les suffixes suivants :

       //TRANSLIT
              Quand la chaine << //TRANSLIT >> est ajoutee a la fin de tocode,
              les translitterations sont activees. Cela signifie que quand un
              caractere ne peut pas etre represente dans le jeu de caracteres
              cible, il peut etre approche 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. Pour revenir a
       l'etat initial, utilisez iconv(3) avec un argument inbuf NULL.

VALEUR RENVOYEE
       En cas de succes, la fonction iconv_open() renvoie un nouveau
       descripteur de conversion. En cas d'echec, elle renvoie et renvoie
       (iconv_t) -1 et definit errno pour indiquer l'erreur.

ERREURS
       Les erreurs suivantes peuvent, entre autres, se presenter :

       EINVAL La conversion depuis fromcode vers tocode n'est pas prise en
              charge par l'implementation.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +--------------------------+--------------------------+----------------+
       |Interface                 | Attribut                 | Valeur         |
       +--------------------------+--------------------------+----------------+
       |iconv_open()              | Securite des threads     | MT-Safe locale |
       +--------------------------+--------------------------+----------------+
STANDARDS
       POSIX.1-2008.

HISTORIQUE
       glibc 2.1. POSIX.1-2001, SUSv2.

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

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org> et David Prevot
       <david@tilapin.org>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                  iconv_open(3)