Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
wcsrtombs - Convertir une chaine de caracteres larges en sequence
multioctet
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 caracteres larges depuis la chaine *src vers la sequence multioctet
situee en dest. Au plus len octets seront ecrits dans dest. L'etat de
conversion *ps est mis a jour. La conversion est realisee en invoquant
wcrtomb(dest,*src,ps) aussi longtemps que cet appel reussit, en
augmentant a chaque fois dest du nombre d'octets ecrits, et en
incrementant *src. La conversion peut se terminer pour trois raisons :
1. Un caractere large que l'on ne peut pas representer par une sequence
multioctet (dans la locale utilisee) a ete rencontre. Dans ce cas *src
pointera sur le caractere invalide, et la fonction renverra (size_t) -1
apres avoir place EILSEQ dans errno.
2. La limite len est atteinte. Dans ce cas *src pointera sur le
caractere suivant a convertir, et la fonction renvoie le nombre
d'octets ecrits dans dest.
3. La chaine de caracteres larges a ete completement convertie, y
compris le L'\0' final (ramenant *ps a l'etat initial). Dans ce cas,
*src devient NULL, et la fonction renvoie le nombre d'octets ecrits
dans dest, sans compter l'octet '\0'.
Si dest est NULL, la longueur len est ignoree, et la conversion se
deroule comme precedemment, sauf que les octets convertis ne sont pas
ecrits en memoire, et qu'il n'y a pas de limite de longueur en
destination.
Dans tous les cas, si ps est un pointeur NULL, un etat statique anonyme
propre a la fonction wcsrtombs est utilise a la place.
Le programmeur doit s'assurer qu'il y a assez de place pour au moins
len octets au minimum dans dest.
VALEUR RENVOY'EE
La fonction wcsrtombs() renvoie le nombre d'octets constituant la
partie convertie de la sequence multioctet, sans compter l'octet nul
final. Si elle rencontre un caractere large qu'elle ne peut convertir,
elle renvoie (size_t) -1 et place EILSEQ dans errno.
CONFORMIT'E
C99.
NOTES
Le comportement de wcsrtombs() depend de la categorie LC_CTYPE de la
locale utilisee.
L'utilisation d'un pointeur NULL pour ps n'est pas sure dans un
contexte multithread.
VOIR AUSSI
iconv(3), wcsnrtombs(3), wcstombs(3)
COLOPHON
Cette page fait partie de la publication 3.27 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Nicolas
Francois et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.