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

#include <stdlib.h>

size_t mbstowcs (wchar_t *pwcs, const char *s, size_t n);

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.

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).

ISO/ANSI C, UNIX98

mbsrtowcs(3)

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é.

Christophe Blaess 2003.