Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
mbsrtowcs - Convertir une sequence multi-octets en chaine de caracteres
larges
SYNOPSIS
#include <wchar.h>
size_t mbsrtowcs(wchar_t *dest, const char **src,
size_t len, mbstate_t *ps);
DESCRIPTION
Si dest n'est pas un pointeur NULL, la fonction mbsrtowcs() convertit
la sequence multi-octets *src en une chaine de caracteres larges
debutant en dest. Au maximum, len caracteres larges sont ecrits dans
dest. L'etat de conversion *ps est mis a jour. La conversion est en
fait realisee en invoquant de facon repetee mbrtowc(dest, *src, n, ps)
ou n est un nombre positif, aussi longtemps que cet appel reussit, en
incrementant chaque fois dest de un et en augmentant *src du nombre
d'octets lus. La conversion peut s'arreter pour trois raisons :
1. Une sequence multi-octets invalide a ete rencontree. Dans ce cas,
*src pointera sur la sequence invalide, et la fonction renvoie
(size_t) -1 en positionnant errno a la valeur EILSEQ.
2. len caracteres larges differents de L'\0' ont ete enregistres en
dest. Dans ce cas, *src pointe sur la sequence multi-octets
suivante, et le nombre de caracteres larges ecrites dans dest est
renvoye.
3. La sequence multi-octets a ete completement convertie, y compris le
'\0' final (ce qui a pour effet de bord de ramener *ps a l'etat
initial). Dans ce cas, *src est mis a NULL, et le nombre de
caracteres ecrits dans dest, moins le L'\0' final, est renvoye.
Si dest est NULL, alors len est ignore, et la conversion se deroule
comme precedemment, sauf que les caracteres convertis ne sont pas
ecrits en memoire, et qu'aucune limite de destination n'est prise en
compte.
Dans tous les cas, si ps est un pointeur NULL, un etat anonyme
statique, reserve a la fonction mbsrtowcs() est utilise a sa place.
Le programmeur doit s'assurer qu'il y assez de place pour au moins len
caracteres larges dans dest.
VALEUR RENVOY'EE
La fonction mbsrtowcs() renvoie le nombre de caracteres larges places
dans la zone convertie, sans compter le caractere nul final. Si une
sequence multi-octets invalide est rencontree, la fonction renvoie
(size_t) -1, et errno contient EILSEQ.
CONFORMIT'E
C99.
NOTES
Le comportement de mbsrtowcs() depend de la categorie LC_CTYPE de la
localisation en cours.
L'utilisation d'un pointeur NULL pour ps n'est pas sure dans un
contexte multithread.
VOIR AUSSI
iconv(3), mbsnrtowcs(3), mbstowcs(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). Florentin
Duneau 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> >>.