Provided by:
manpages-fr_1.67.0-1_all 
NOM
wcsrtombs - Convertir une chaîne de caractères larges en séquence
multi-octets.
SYNOPSIS
#include <wchar.h>
size_t wcsrtombs (char *dest, const wchar_t **src,
size_t len, mbstate_t *ps);
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’\0’ final (ramenant *ps à l’état initial). Dans ce cas,
*src devient NULL, et la fonction renvoie le nombre d’octets écrits
dans dest, sans compter l’octet ’\0’.
Si dest est NULL, la longueur len est ignorée, et la conversion se
déroule comme précédemment, sauf que les octets convertis ne sont pas
écrits en mémoire, et qu’il n’y a pas de limite de longueur en
destination.
Dans tous les cas, si ps est un pointeur NULL, un état statique anonyme
propre à la fonction est utilisé à la place.
Le programmeur doit s’assurer qu’il y a assez de place pour len octets
au minimum dans dest.
VALEUR RENVOYÉE
La fonction wcsrtombs renvoie le nombre d’octets constituant la partie
convertie de la séquence multi-octets, sans compter l’octet nul final.
Si elle rencontre un caractère large qu’elle ne peut convertir, elle
renvoie (size_t)(-1) et place EILSEQ errno .
CONFORMITÉ
ISO/ANSI C, UNIX98
VOIR AUSSI
wcstombs(3), wcsnrtombs(3), iconv(3)
NOTES
Le comportement de wcsrtombs dépend de la catégorie LC_CTYPE de la
localisation.
L’utilisation d’un pointeur NULL pour ps n’est pas sûre dans un
contexte multithreads.
TRADUCTION
Christophe Blaess, 2000-2003.