Nom

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

Résumé

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

Description

Si dest n'est pas un pointeur NULL, la fonction wcsrtombs convertit les 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. La limite len est atteinte. Dans ce cas *src pointera sur le caractère suivant à convertir, et la fonction renvoie le nombre d'octets écrits dans dest.

3. La chaîne de caractères larges a été complètement convertie, y compris le L'