Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

NOM

       wcrtomb - Convertir un caractere large en sequence multioctet

SYNOPSIS

       #include <wchar.h>

       size_t wcrtomb(char *s, wchar_t wc, mbstate_t *ps);

DESCRIPTION

       L'utilisation  principale  de  cette  fonction  est le cas ou s est non
       NULL, et wc n'est pas L'\0'. Alors, la fonction wcrtomb() convertit  le
       caractere  large  wc dans sa representation multioctet, et l'enregistre
       au debut de la chaine  pointee  par  s.  Elle  met  a  jour  l'etat  de
       conversion *ps, et renvoie la longueur de la representation multioctet,
       c'est-a-dire le nombre d'octets ecrits en s.

       Une autre possibilite peut se presenter quand s est non NULL,  mais  wc
       vaut L'\0'. Dans cette situation, la fonction wcrtomb() enregistre dans
       la chaine  de  caracteres  pointee  par  s  la  sequence  de  decalages
       necessaire pour ramener *ps a son etat initial, suivie d'un octet '\0'.
       Elle met a jour l'etat *ps  (le  ramene  donc  a  l'etat  initial),  et
       renvoie  la  longueur  de  la  sequence  en ajoutant un pour compter le
       caractere nul final, c'est-a-dire le nombre d'octets ecrits dans s.

       Un troisieme cas se presente quand s est NULL. Alors, wc est ignore, et
       la  fonction  renvoie  alors le resultat de wcrtomb(tampon,L'\0',ps) ou
       tampon est un tampon interne.

       Dans tous les cas ci-dessus, si  ps  est  un  pointeur  NULL,  un  etat
       statique  interne  est  utilise  a  la place, qui n'est connu que de la
       fonction wcrtomb().

VALEUR RENVOY'EE

       La fonction wcrtomb() renvoie le nombre d'octets qui ont ete -  ou  qui
       auraient  ete  -  ecrits  dans le tableau d'octets s. Si wc ne peut pas
       etre represente comme  une  sequence  multioctet  (dans  la  locale  en
       cours), elle renvoie (size_t) -1, et place EILSEQ dans errno.

CONFORMIT'E

       C99.

NOTES

       Le  comportement  de  wcrtomb()  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

       wcsrtombs(3)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.32 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> >>.