NOM

       wctomb - Convertir un caractère large en séquence multioctet

SYNOPSIS

       #include <stdlib.h>

       int wctomb(char *s, wchar_t wc);

DESCRIPTION

       Si  s  n'est  pas  NULL,  la  fonction  wctomb()  convertit  le caractère large wc dans sa représentation
       multioctet et le stocke au début de la chaîne de caractères pointée par s. Elle  met  à  jour  l'état  de
       décalage,  variable  statique  anonyme  connue  uniquement  d'elle-même,  et  renvoie  la  longueur de la
       représentation multioctet, c'est-à-dire le nombre d'octets écrits dans s.

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

       Si s est NULL, la fonction wctomb() réinitialise l'état de décalage, connu seulement de cette fonction, à
       sa  valeur  initiale  et renvoie une valeur non nulle si l'encodage a un état de décalage non trivial, ou
       zéro si l'encodage est sans état.

VALEUR RENVOYÉE

       Si s n'est pas NULL, la fonction wctomb() renvoie le nombre d'octets qui ont été écrits dans  le  tableau
       d'octets  à l'adresse s. Si wc ne peut pas être représenté par une séquence multioctet (d'après la locale
       utilisée), elle renvoie -1.

       Si s est NULL, la fonction wctomb() renvoie une valeur non nulle si l'encodage a un état de décalage  non
       trivial, ou zéro si l'encodage est sans état.

ATTRIBUTS

   Multithreading (voir pthreads(7))
       La fonction wctomb() n'est pas sûre dans un contexte multithread.

CONFORMITÉ

       C99.

NOTES

       Le comportement de wctomb() dépend de la catégorie LC_CTYPE de la locale utilisée.

       La fonction wcrtomb(3) fournit une meilleure interface pour la même fonctionnalité.

VOIR AUSSI

       MB_CUR_MAX(3), mblen(3), mbstowcs(3), mbtowc(3), wcrtomb(3), wcstombs(3)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux. Une description du projet et des
       instructions    pour    signaler    des    anomalies    peuvent     être     trouvées     à     l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Christophe      Blaess      <http://www.blaess.fr/christophe/>      (1996-2003),       Alain       Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Nicolas  François  et  l'équipe  francophone de traduction de
       Debian (2006-2009).

       Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org>  ou  par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».