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

NOM

       mbstowcs  -  Convertir  une  chaine  de  caracteres multi-octets en une
       chaine de caracteres larges

SYNOPSIS

       #include <stdlib.h>

       size_t mbstowcs(wchar_t *dest, const char *src, size_t n);

DESCRIPTION

       Si dest n'est pas un pointeur NULL, la fonction mbstowcs() convertit la
       chaine  multi-octets  src  en  chaine  de  caracteres larges dest. Elle
       ecrira au plus n caracteres larges dans dest. L'etat de conversion  est
       initialise.  La  conversion peut s'arreter pour l'une des trois raisons
       suivantes :

       1. Une sequence multi-octets invalide a ete rencontree.  Dans  ce  cas,
          elle renvoie (size_t) -1.

       2. n caracteres larges non nuls ont ete stockes dans dest. Dans ce cas,
          le nombre de caracteres ecrits dans dest est renvoye, mais l'etat de
          decalage en ce point est perdu.

       3. La  chaine  multi-octets  a ete completement convertie, y compris le
          caractere nul final. Dans ce cas, le  nombre  de  caracteres  larges
          ecrits dans dest, sans compter le caractere nul final, est renvoye.

       Le  programmeur doit s'assurer qu'il y a assez de place pour au moins n
       caracteres larges dans dest.

       Si dest est NULL, n est ignore, et  la  conversion  se  presente  comme
       au-dessus,  excepte  que  les  caracteres  larges ne sont pas ecrits en
       memoire et qu'aucune limite de longueur n'existe.

       Afin d'eviter la situation numero  2  ci-dessus,  le  programmeur  doit
       s'assurer que n est superieur ou egal a mbstowcs(NULL,src,0)+1.

VALEUR RENVOY'EE

       La  fonction  mbstowcs()  renvoie  le  nombre  de caracteres larges qui
       constituent la partie convertie de la chaine, sans compter le caractere
       nul  final.  Si une sequence multi-octets invalide est rencontree, elle
       renvoie (size_t) -1.

CONFORMIT'E

       C99.

NOTES

       Le comportement de mbstowcs() depend de la  categorie  LC_CTYPE  de  la
       localisation en cours.

       La  fonction  mbsrtowcs(3) fournit une meilleure interface pour la meme
       fonctionnalite.

VOIR AUSSI

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