Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] mbtowc - Convertir une séquences multi-octets en caractères étendus. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <stdlib.h>[/b] [b][i]int mbtowc (wchar_t * pwc , const char * s , size_t n );[/i][/b] .fi [size=18] [b]Description[/b] [/size] L'utilisation habituelle de cette fonction est avec [i]s[/i] et [i]pwc[/i] tous deux différents [b]NULL .[/b] Dans ce cas, la fonction [b]mbtowc[/b] examine au plus [i]n[/i] octets de la chaîne multi-octets commençant à l'adresse [b]s ,[/b] extrait le premier caractère multi-octets complet, le convertit en caractère large et le stocke dans [b]*pwc .[/b] Elle met à jour l'état interne de décalage, connu d'elle seule. Si [i]s[/i] ne pointe pas sur un octet nul, elle renvoie le nombre d'octets qui ont été consommés dans [b]s ,[/b] sinon, elle renvoie zéro. Si les [i]n[/i] octets débutant en [i]s[/i] ne contiennent pas un caractère multi-octets complet, ou s'il s'agit d'une séquence invalide, [b]mbtowc[/b] renvoie -1. Ceci peut se produire même si [i]n[/i] est supérieur ou égal à [b]MB_CUR_MAX ,[/b] si la chaîne multi-octets contient des séquences de décalage redondantes. Un autre cas possible se présent si [i]s[/i] est non [b]NULL ,[/b] mais [i]pwc[/i] est [b]NULLL .[/b] Dans ce cas, la fonction [b]mbtowc ()[/b] se comporte comme ci-dessus, mais ne stocke par le caractère large en mémoire. Un troisième cas est possible si [i]s[/i] est [b]NULL .[/b] Alors, [i]pwc[/i] et [i]n[/i] sont ignorés. La fonction [b]mbtowc ()[/b] réinitialise l'état de décalage, qu'elle seule connait, et renvoie une valeur non-nulle si l'encodage à un état de décalage non trivial, ou zéro si l'encodage est sans état. [size=18] [b]Valeur renvoyée[/b] [/size] Si [i]s[/i] est non [b]NULL ,[/b] la fonction [b]mbtowc ()[/b] renvoie le nombre d'octets consommés à partir de [b]s ,[/b] ou zéro si [i]s[/i] pointe sur un octet nul, ou encore -1 en cas d'erreur. Si [i]s[/i] est [b]NULL ,[/b] la fonction [b]mbtowc ()[/b] renvoie une valeur non-nulle si l'encodage a un état de décalage non trivial, ou zéro si l'encodage est sans état. [size=18] [b]Conformité[/b] [/size] ISO/ANSI C, UNIX98 [size=18] [b]Voir aussi[/b] [/size] [b]mbrtowc (3),[/b] [b]mbstowcs (3),[/b] [b]MB_CUR_MAX (3)[/b] [size=18] [b]Notes[/b] [/size] Le comportement de [b]mbtowc ()[/b] dépend de la catégorie [b]LC_CTYPE[/b] de la localisation en cours. Cette fonction n'est pas sûre en contexte multi-threads. La fonction [b]mbrtowc ()[/b] fournit une meilleure interface pour la même fonctionnalité. SH TRADUCTION Christophe Blaess, 1996-2003.
Fichier