Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] mbstowcs - Convertir une chaîne de caractères multi-octets en une chaîne de caractères étendus. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <stdlib.h>[/b] [b][i]size_t mbstowcs (wchar_t * pwcs , const char * s , size_t n );[/i][/b] .fi [size=18] [b]Description[/b] [/size] Si [i]dest[/i] n'est pas un pointeur [b]NULL ,[/b] la fonction [b]mbstowcs ()[/b] convertit la chaîne multi-octets [i]src[/i] en chaîne de caractères larges [b]dest .[/b] Elle écrira au plus [i]n[/i] octets dans [b]dest .[/b] L'état de conversion est initialisé. La conversion peut s'arrêter pour l'une des trois raisons suivantes : 1. Une séquence multi-octets invalide a été rencontrée. Dans ce cas, elle renvoie (size_t)(-1). 2. [i]n[/i] caractères larges non-nuls ont été stockés dans [b]dest .[/b] Dans ce cas le nobre de caractères écrits dans [i]dest[/i] est renvoyé, mais l'état de décalage en ce point est perdu. 2. La chaîne multi-octets a été complètement convertie, y compris le caractère nul final. Dans ce cas, le nombre de caractères larges écrits dans [b]dest ,[/b] sans compter le caractère nul final, est renvoyé. Le programmeur doit s'assurer qu'il y a assez de place pour au moins [i]n[/i] caractères larges dans [b]dest .[/b] Si [i]dest[/i] est [b]NULL ,[/b] [i]n[/i] est ignoré, et la conversion se présente comme au-dessus, excepté que les caractères larges ne sont pas écris en mémoire et qu'aucune limite de longueur n'existe. Afin d'éviter la situation numéro 2 ci-dessus, le programmeur doit s'assurer que [i]n[/i] est supérieur ou égal a [b]mbstowcs(NULL,src,0)+1 .[/b] [size=18] [b]Valeur renvoyée[/b] [/size] La fonction [b]mbstowcs ()[/b] renvoie le nombre de caractères larges qui constituent la partie convertie de la chaîne, sans compter le caractère nul final. Si une séquence multi-octets invalide est rencontrée, elle renvoie (size_t)(-1). [size=18] [b]Conformité[/b] [/size] ISO/ANSI C, UNIX98 [size=18] [b]Voir aussi[/b] [/size] [b]mbsrtowcs (3)[/b] [size=18] [b]Notes[/b] [/size] Le comportement de [b]mbstowcs[/b] dépend de la catégorie [b]LC_CTYPE[/b] de la localisation en cours. La fonction [b]mbsrtowcs (2)[/b] fournit une meilleure interface pour la même fonctionnalité. [size=18] [b]Traduction[/b] [/size] Christophe Blaess 2003.
Fichier