Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

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> >>.