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

NOM

       wcstombs  -  Convertir  une  chaine  de caracteres etendus en chaine de
       caracteres multioctet

SYNOPSIS

       #include <stdlib.h>

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

DESCRIPTION

       Si dest n'est pas un pointeur NULL, la fonction wcstombs() convertit la
       chaine  de  caracteres larges src vers la sequence multioctet situee en
       dest. Au plus n octets seront ecrits dans dest.  La  conversion  debute
       dans  l'etat  initial.  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, la
       fonction renverra (size_t) -1.

       2. La limite de longueur force l'arret. Dans ce cas, le nombre d'octets
       ecrits dans dest est renvoye, mais l'etat de decalage est perdu.

       3.  La  chaine  de  caracteres  larges  a ete completement convertie, y
       compris le L'\0' final. Dans ce cas,  la  conversion  se  termine  dans
       l'etat  initial.  La  fonction  renvoie  le nombre d'octets ecrits dans
       dest, sans compter l'octet '\0' final.

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

       Si  dest  est  NULL,  la  longueur  n  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.

       Pour eviter le cas 2 ci-dessus, le programmeur doit s'assurer que n est
       superieur ou egal a wcstombs(NULL,src,0)+1.

VALEUR RENVOY'EE

       La fonction wcstombs() 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.

CONFORMIT'E

       C99.

NOTES

       Le comportement de wcstombs() depend de la  categorie  LC_CTYPE  de  la
       locale utilisee.

       La  fonction  wcsrtombs(3)  fournit  une  interface  sure  en  contexte
       multithread pour la meme fonctionnalite.

VOIR AUSSI

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