perkamon - en to fr translation catalogue (40 entries)

note: type: TH
en: 2012-05-10
fr: 10 mai 2012

note: type: TH
en: Linux Programmer's Manual
fr: Manuel du programmeur Linux

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: iconv - perform character set conversion
fr: iconv - Conversion de jeux de caractères

note: type: Plain text
en: The B<iconv>()  function converts a sequence of characters in one character encoding to a sequence of characters in another character encoding.  The I<cd> argument is a conversion descriptor, previously created by a call to B<iconv_open>(3); the conversion descriptor defines the character encodings that B<iconv>()  uses for the conversion.  The I<inbuf> argument is the address of a variable that points to the first character of the input sequence; I<inbytesleft> indicates the number of bytes in that buffer.  The I<outbuf> argument is the address of a variable that points to the first byte available in the output buffer; I<outbytesleft> indicates the number of bytes available in the output buffer.
fr: La fonction B<iconv>() convertit une séquence de caractères dans un jeu de caractères en une séquence de caractères dans un autre jeu de caractères. Le paramètre I<cd> est un descripteur de conversion (en anglais I<conversion descriptor>), créé préalablement par un appel à B<iconv_open>(3) ; le descripteur de conversion définit les jeux de caractères qu'B<iconv>() utilise pour cette conversion. Le paramètre I<inbuf> est l'adresse d'une variable qui pointe vers le premier caractère de la séquence d'entrée ; le paramètre I<outbuf> est l'adresse d'une variable qui pointe vers le premier octet disponible dans le tampon de sortie, et I<outbytesleft> indique le nombre d'octets disponibles dans le tampon de sortie.

note: type: Plain text
en: The main case is when I<inbuf> is not NULL and I<*inbuf> is not NULL.  In this case, the B<iconv>()  function converts the multibyte sequence starting at I<*inbuf> to a multibyte sequence starting at I<*outbuf>.  At most I<*inbytesleft> bytes, starting at I<*inbuf>, will be read.  At most I<*outbytesleft> bytes, starting at I<*outbuf>, will be written.
fr: Cette routine est principalement utilisée quand I<inbuf> et I<*inbuf> sont non NULL. Dans ce cas, B<iconv>() convertit la séquence multioctet débutant en I<*inbuf> en une séquence multioctet commençant en I<*outbuf>. Au plus I<*inbytesleft> octets seront lus, en partant de I<*inbuf>. Au plus I<*outbytesleft> octets seront écrits en commençant en I<*outbuf>.

note: type: Plain text
en: The B<iconv>()  function converts one multibyte character at a time, and for each character conversion it increments I<*inbuf> and decrements I<*inbytesleft> by the number of converted input bytes, it increments I<*outbuf> and decrements I<*outbytesleft> by the number of converted output bytes, and it updates the conversion state contained in I<cd>.  If the character encoding of the input is stateful, the B<iconv>()  function can also convert a sequence of input bytes to an update to the conversion state without producing any output bytes; such input is called a I<shift sequence>.  The conversion can stop for four reasons:
fr: La fonction B<iconv>() convertit un caractère multioctet à la fois. Pour chaque conversion, elle augmente I<*inbuf> et diminue I<*inbytesleft> du nombre d'octets d'entrée convertis, et elle augmente I<*outbuf> et diminue I<*outbytesleft> du nombre d'octets de sortie écrits et met à jour l'état de conversion contenu au sein de I<cd>. La conversion peut s'arrêter pour quatre raisons\ :

note: type: Plain text
en: An invalid multibyte sequence is encountered in the input.  In this case, it sets I<errno> to B<EILSEQ> and returns I<(size_t)\ -1>.  I<*inbuf> is left pointing to the beginning of the invalid multibyte sequence.
fr: Une séquence multioctet invalide a été trouvée en entrée. Dans ce cas, I<errno> est définie à B<EILSEQ> et la fonction renvoie I<(size_t)\ -1>. Ensuite, I<*inbuf> pointera sur le début de la séquence multioctet invalide.

note: type: Plain text
en: The input byte sequence has been entirely converted, that is, I<*inbytesleft> has gone down to 0.  In this case, B<iconv>()  returns the number of nonreversible conversions performed during this call.
fr: La séquence d'entrée multioctet a été convertie entièrement, c'est-à-dire que I<*inbytesleft> est descendu jusqu'à zéro. Dans ce cas, B<iconv>() renvoie le nombre de conversions irréversibles réalisées durant l'appel.

note: type: Plain text
en: An incomplete multibyte sequence is encountered in the input, and the input byte sequence terminates after it.  In this case, it sets I<errno> to B<EINVAL> and returns I<(size_t)\ -1>.  I<*inbuf> is left pointing to the beginning of the incomplete multibyte sequence.
fr: Une séquence multioctet incomplète a été trouvée alors que la séquence d'entrée se terminait. Dans ce cas, I<errno> est définie à B<EINVAL> et la fonction renvoie I<(size_t)\ -1>. Ensuite, I<*inbuf> pointera sur le début de la séquence multioctet incomplète.

note: type: Plain text
en: The output buffer has no more room for the next converted character.  In this case, it sets I<errno> to B<E2BIG> and returns I<(size_t)\ -1>.
fr: Le tampon de sortie n'a plus de place pour stocker le prochain caractère converti. Dans ce cas, I<errno> contiendra B<E2BIG> et la fonction renverra I<(size_t)\ -1>.

note: type: Plain text
en: A different case is when I<inbuf> is NULL or I<*inbuf> is NULL, but I<outbuf> is not NULL and I<*outbuf> is not NULL.  In this case, the B<iconv>()  function attempts to set I<cd>'s conversion state to the initial state and store a corresponding shift sequence at I<*outbuf>.  At most I<*outbytesleft> bytes, starting at I<*outbuf>, will be written.  If the output buffer has no more room for this reset sequence, it sets I<errno> to B<E2BIG> and returns I<(size_t)\ -1>.  Otherwise it increments I<*outbuf> and decrements I<*outbytesleft> by the number of bytes written.
fr: Une autre possibilité se présente quand I<inbuf> ou I<*inbuf> est NULL, mais si ni I<outbuf>, ni I<*outbuf> ne le sont. Dans ce cas, la fonction B<iconv>() essaye de mettre l'état de conversion de I<cd> dans l'état initial, et de mémoriser la séquence de décalage correspondante dans I<*outbuf>. Au maximum I<*outbytesleft> octets seront écrits en commençant en I<*outbuf>. Si le tampon de sortie ne contient pas assez de place pour réinitialiser la séquence, I<errno> est définie à B<E2BIG> et la fonction renvoie I<(size_t)\ -1>. Sinon, elle augmente I<*outbuf> et diminue I<*outbytesleft> du nombre d'octets écrits.

note: type: Plain text
en: A third case is when I<inbuf> is NULL or I<*inbuf> is NULL, and I<outbuf> is NULL or I<*outbuf> is NULL.  In this case, the B<iconv>()  function sets I<cd>'s conversion state to the initial state.
fr: Un troisième cas est possible, si I<inbuf> ou I<*inbuf> est NULL, et si I<outbuf> ou I<*outbuf> est NULL. Dans ce cas, la fonction B<iconv>() replace l'état de conversion I<cd> dans l'état de conversion initial.

note: type: SH
en: RETURN VALUE
fr: VALEUR RENVOYÉE

note: type: Plain text
en: The B<iconv>()  function returns the number of characters converted in a nonreversible way during this call; reversible conversions are not counted.  In case of error, it sets I<errno> and returns I<(size_t)\ -1>.
fr: La fonction B<iconv>() renvoie le nombre de caractères convertis de manière irréversible durant l'appel. Les conversions réversibles ne sont pas prises en compte. En cas d'erreur la fonction remplit I<errno> et renvoie I<(size_t)\ -1>.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: The following errors can occur, among others:
fr: Les erreurs suivantes peuvent se produire, entre autres\ :

note: type: Plain text
en: There is not sufficient room at I<*outbuf>.
fr: Il n'y a pas assez de place dans I<*outbuf>.

note: type: Plain text
en: An invalid multibyte sequence has been encountered in the input.
fr: Une séquence multioctet invalide a été trouvée en entrée.

note: type: Plain text
en: An incomplete multibyte sequence has been encountered in the input.
fr: Une séquence multioctet incomplète a été trouvée en entrée.

note: type: Plain text
en: This function is available in glibc since version 2.1.
fr: Cette fonction est disponible dans la glibc depuis la version\ 2.1.

note: type: SH
en: CONFORMING TO
fr: CONFORMITÉ

note: type: Plain text
en: Although I<inbuf> and I<outbuf> are typed as I<char\ **>, this does not mean that the objects they point can be interpreted as C strings or as arrays of characters: the interpretation of character byte sequences is handled internally by the conversion functions.  In some encodings, a zero byte may be a valid part of a multibyte character.
fr: Bien qu'I<inbuf> et I<outbuf> soient déclarés de type I<char\ **>, cela ne signifie pas que les objets vers lesquels ils pointent puissent être interprétés comme des chaînes de caractères C ou comme des tableaux de caractères ; l'interprétation des séquences d'octets comme caractères est gérée de manière interne par les fonctions de conversion. Dans certains jeux de caractères, un octet nul peut être une partie valide d'un caractère multioctet.

note: type: Plain text
en: The caller of B<iconv>()  must ensure that the pointers passed to the function are suitable for accessing characters in the appropriate character set.  This includes ensuring correct alignment on platforms that have tight restrictions on alignment.
fr: Celui qui appelle B<iconv>() doit s'assurer que les pointeurs passés à la fonction permettent d'accéder aux caractères dans le jeu de caractères approprié. Il faut en particulier assurer un alignement correct sur les plateformes qui ont des exigences très strictes en matière d'alignement.

note: type: SH
en: SEE ALSO
fr: VOIR AUSSI

note: type: Plain text
en: This page is part of release 3.65 of the Linux I<man-pages> project.  A description of the project, and information about reporting bugs, can be found at \%http://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 3.65 du projet I<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/.

note: type: TH
en: 2008-08-11
fr: 11 août 2008

note: type: Plain text
en: iconv_close - deallocate descriptor for character set conversion
fr: iconv_close - Libérer un descripteur de conversion de caractères

note: type: Plain text
en: The B<iconv_close>()  function deallocates a conversion descriptor I<cd> previously allocated using B<iconv_open>(3).
fr: La fonction B<iconv_close>() libère le descripteur de conversion I<cd> alloué préalablement avec B<iconv_open>(3).

note: type: Plain text
en: When successful, the B<iconv_close>()  function returns 0.  In case of error, it sets I<errno> and returns -1.
fr: Lorsqu'elle réussit, la fonction B<iconv_close>() renvoie 0. En cas d'erreur, elle remplit I<errno> et renvoie -1.

note: type: Plain text
en: iconv_open - allocate descriptor for character set conversion
fr: iconv_open - Allouer un descripteur pour une conversion de jeux de caractères

note: type: Plain text
en: The B<iconv_open>()  function allocates a conversion descriptor suitable for converting byte sequences from character encoding I<fromcode> to character encoding I<tocode>.
fr: La fonction B<iconv_open>() alloue un descripteur de conversion adapté à la transformation d'une séquence d'octets depuis le codage de caractères I<fromcode> dans le codage I<tocode>.

note: type: Plain text
en: The values permitted for I<fromcode> and I<tocode> and the supported combinations are system-dependent.  For the GNU C library, the permitted values are listed by the I<iconv --list> command, and all combinations of the listed values are supported.  Furthermore the GNU C library and the GNU libiconv library support the following two suffixes:
fr: Les valeurs autorisées pour I<fromcode> et I<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 I<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 :

note: type: Plain text
en: When the string "//TRANSLIT" is appended to I<tocode>, transliteration is activated.  This means that when a character cannot be represented in the target character set, it can be approximated through one or several similarly looking characters.
fr: Quand la chaîne « //TRANSLIT » est ajoutée à la fin de I<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.

note: type: Plain text
en: When the string "//IGNORE" is appended to I<tocode>, characters that cannot be represented in the target character set will be silently discarded.
fr: Quand la chaîne « //IGNORE » est ajoutée à la fin de I<tocode>, les caractères qui ne peuvent pas être représentés dans le jeu de caractères cible sont simplement ignorés.

note: type: Plain text
en: The resulting conversion descriptor can be used with B<iconv>(3)  any number of times.  It remains valid until deallocated using B<iconv_close>(3).
fr: Le descripteur de conversion résultant peut être utilisé autant de fois que voulu avec B<iconv>(3). Il reste valide jusqu'à sa libération avec B<iconv_close>(3).

note: type: Plain text
en: A conversion descriptor contains a conversion state.  After creation using B<iconv_open>(), the state is in the initial state.  Using B<iconv>(3)  modifies the descriptor's conversion state.  (This implies that a conversion descriptor can not be used in multiple threads simultaneously.)  To bring the state back to the initial state, use B<iconv>(3)  with NULL as I<inbuf> argument.
fr: Un descripteur de conversion contient un état de conversion. Lors de sa création avec B<iconv_open>(), il se trouve dans l'état initial. L'utilisation de B<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 B<iconv>(3) avec un argument I<inbuf> NULL.

note: type: Plain text
en: The B<iconv_open>()  function returns a freshly allocated conversion descriptor.  In case of error, it sets I<errno> and returns I<(iconv_t)\ -1>.
fr: La fonction B<iconv_open>() renvoie un nouveau descripteur de conversion. En cas d'erreur, elle remplit I<errno> et renvoie I<(iconv_t)\ -1>.

note: type: Plain text
en: The following error can occur, among others:
fr: Les erreurs suivantes peuvent, entre autres, se présenter\ :

note: type: Plain text
en: The conversion from I<fromcode> to I<tocode> is not supported by the implementation.
fr: La conversion depuis I<fromcode> vers I<tocode> n'est pas supportée par l'implémentation.
