Nom

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

Résumé

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

Description

La fonction wcsnrtombs est l'équivalent de wcsrtombs, sauf que le nombre de caractères larges à convertir est limité (à nwc), en commençant en *src.

Si dest n'est pas un pointeur NULL, la fonction wcsnrtombs convertit au maximum nwc caractères larges depuis la chaîne *src vers la séquence multi-octets située en dest. Au plus len octets seront écrits dans dest. L'état de conversion *ps est mis à jour. La conversion est réalisée en fait en invoquant à répétition wcrtomb(dest,*src,ps), aussi longtemps que cet appel réussit, en augmentant à chaque fois dest du nombre d'octets écrits, et en incrémentant *src. La conversion peut se terminer pour trois raisons :

1. Un caractère large que l'on ne peut pas représenter par une séquence multi-octets (dans la localisation en cours) a été rencontré. Dans ce cas *src pointera sur le caractère invalide, et la fonction renverra (size_t)(-1) après avoir placé EILSEQ dans errno.

2. On a converti nwc caractères larges sans rencontrer L'