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

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