Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] iconv - Conversion de caractères larges. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <iconv.h>[/b] [b][i]size_t iconv (iconv_t cd ,[/i][/b] [b][i] char ** inbuf , size_t * inbytesleft ,[/i][/b] [b][i] char ** outbuf , size_t * outbytesleft );[/i][/b] .fi [size=18] [b]Description[/b] [/size] L'argument [i]cd[/i] doit être un descripteur de conversion fourni par la fonction [b]iconv_open[/b]. L'utilisation principale de cette routine est avec [i]inbuf[/i] non NULL et [i]inbuf[/i] non NULL. Dans ce cas, [b]iconv[/b] convertit la séquence multi-octets débutant en [i]inbuf[/i] en une séquence multi-octets commençant en [i]outbuf[/i]. Au plus [i]inbytesleft[/i] octets seront lus, en partant de [i]inbuf[/i]. Au plus [i]outbytesleft[/i] octets seront écrits en commençant en [i]outbuf[/i]. La fonction [b]iconv[/b] convertit un caractère multi-octets à la fois, et pour chaque conversion elle augmente [i]inbuf[/i] et diminue [i]inbytesleft[/i] du nombre d'octets d'entrée convertis, et elle augmente [i]outbuf[/i] et diminue [i]outbytesleft[/i] du nombre d'octets de sortie écrits. Elle met à jour l'état de conversion contenu au sein de [i]cd[/i]. La conversion peut s'arrêter pour quatre raisons : 1. Une séquence multi-octets invalide a été trouvée en entrée. Dans ce cas la fonction renvoie (size_t)(-1) après avoir mis [b]EILSEQ[/b] dans [b]errno[/b]. Ensuite [i]inbuf[/i] pointera sur le début de la séquence multi-octets invalide. 2. La séquence d'entrée a été convertie entièrement, c'est à dire que [i]inbytesleft[/i] est descendu jusqu'à zéro. Dans ce cas [b]iconv[/b] renvoie le nombre de conversions irréversibles réalisées durant l'appel. 3. Une séquence multi-octets incomplète a été trouvée alors que la séquence d'entrée se terminait. Dans ce cas la fonction renvoie (size_t)(-1) après avoir mis [b]EINVAL[/b] dans [b]errno[/b]. Ensuite [i]inbuf[/i] pointera sur le début de la séquence multi-octets incomplète. 4. Le buffer de sortie n'a plus de place pour stocker le prochain caractère converti. Dans ce cas [b]errno[/b] contiendra [b]E2BIG[/b] et la fonction renverra (size_t)(-1). Une autre possibilité se présente quand [i]inbuf[/i] ou [i]inbuf[/i] sont NULL, mais ni [i]outbuf[/i], ni [i]outbuf[/i] ne sont NULL. Dans ce cas la fonction [b]iconv[/b] essaye de mettre l'état de conversion de [i]cd[/i] dans l'état initial, et de mémoriser la séquence de décalage correspondante dans [i]outbuf[/i]. Au maximum [i]outbytesleft[/i] octets seront écrits en commençant en [i]outbuf[/i]. Si le buffer de sortie ne contient pas assez de place pour réinitialiser la séquence, la fonction renvoie (size_t)(-1) après avoir mis [b]E2BIG[/b] dans [b]errno[/b]. Sinon elle augmente [i]outbuf[/i] et dimininue [i]outbytesleft[/i] du nombre d'octets écrits. Un troisième cas est possible, si [i]inbuf[/i] ou [i]inbuf[/i] sont NULL, et [i]outbuf[/i] ou [i]outbuf[/i] sont NULL. Alors, la fonction [b]iconv[/b] replace [i]cd[/i] dans l'état de conversion initial. [size=18] [b]Valeur renvoyée[/b] [/size] La fonction [b]iconv[/b] 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 [b]errno[/b] et renvoie (iconv_t)(-1). [size=18] [b]Erreurs[/b] [/size] Les erreurs suivantes peuvent se produire, entre autres : [b]E2BIG[/b] [table][row][col]    [/col][col]Il n'y a pas assez de place dans [i]outbuf[/i].[/col][/row][/table] [b]EILSEQ[/b] [table][row][col]    [/col][col]Une séquence multi-octets invalide a été trouvée en entrée.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Une séquence multi-octets incomplète a été trouvée en entrée.[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] UNIX98 [size=18] [b]Voir aussi[/b] [/size] [b]iconv_open (3), [/b] [b]iconv_close (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2000-2003.
Fichier