Nom

mbstowcs - Convertir une chaîne de caractères multi-octets en une chaîne de caractères étendus.

Résumé

.nf #include <stdlib.h> size_t mbstowcs (wchar_t * pwcs , const char * s , size_t n ); .fi

Description

Si dest n'est pas un pointeur NULL , la fonction mbstowcs () convertit la chaîne multi-octets src en chaîne de caractères larges dest . Elle écrira au plus n octets dans dest . 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. n caractères larges non-nuls ont été stockés dans dest . Dans ce cas le nobre de caractères écrits dans dest 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 dest , sans compter le caractère nul final, est renvoyé.

Le programmeur doit s'assurer qu'il y a assez de place pour au moins n caractères larges dans dest .

Si dest est NULL , n 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 n est supérieur ou égal a mbstowcs(NULL,src,0)+1 .

Valeur renvoyée

La fonction mbstowcs () 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).

Conformité

ISO/ANSI C, UNIX98

Voir aussi

mbsrtowcs (3)

Notes

Le comportement de mbstowcs dépend de la catégorie LC_CTYPE de la localisation en cours.

La fonction mbsrtowcs (2) fournit une meilleure interface pour la même fonctionnalité.

Traduction

Christophe Blaess 2003.