Nom

mbsnrtowcs - Convertir une séquence multi-octets en chaîne de caractères larges.

Résumé

.nf #include <wchar.h> size_t mbsnrtowcs (wchar_t * dest , const char ** src , size_t nms , size_t len , mbstate_t * ps ); .fi

Description

La fonction mbsnrtowcs est équivalente à la fonction mbsrtowcs, sauf qu'elle ne convertit qu'un nombre limité (à nms) d'octets commençant en *src.

Si dest n'est pas un pointeur NULL, la fonction mbsnrtowcs convertit au plus nms octets depuis la séquence multi-octets *src en une chaîne de caractères larges située à dest. Au maximum len caractères larges sont écrits dans dest. L'état de conversion *ps est mis à jour. La conversion est réalisée en fait en invoquant à répétition mbrtowc(dest,*src,n,ps), où n est un nombre positif, aussi longtemps que l'appel réussit, puis en incrémentant dest et en augmentant *src du nombre d'octets lus. La conversion peut s'arrêter pour trois raisons :

1. Une séquence multi-octets invalide a été rencontrée. Dans ce cas, *src pointera sur la séquence invalide, et la fonction renvoie (size_t)(-1) en positionnant errno à la valeur EILSEQ.

2. L'arrêt est forcé à cause de la limite nms, ou si len caractères larges différents de L'