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), wcrtomb(3), wcstombs(3)

COLOPHON

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