Provided by: manpages-fr_1.67.0-1_all bug

NOM

       wctomb - Convertir un caractère étendu en caractère multi-octet.

SYNOPSIS

       #include <stdlib.h>

       int wctomb (char *s, wchar_t wchar);

DESCRIPTION

       Si s n’est pas NULL, la fonction wctomb convertit le caractère large wc
       dans sa représentation multi-octets 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 de la fonction  wctomb,  et
       renvoie  la  longueur de la représentation multioctets, c’est à dire le
       nombre d’octets écrits dans s.

       Le programmeur doit s’assurer qu’il  y  a  suffisament  de  place  pour
       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é  écrit dans la chaîne d’octet à l’adresse s. Si wc ne peut pas
       être représenté par une séquence multi-octets (d’après la  localisation
       en cours), 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.

CONFORMITÉ

       ISO/ANSI C, UNIX98

VOIR AUSSI

       wcrtomb(3), wcstombs(3), MB_CUR_MAX(3)

NOTES

       Le  comportement  de  wctomb  dépend  de  la  catégorie  LC_TYPE  de la
       localisation en cours.

       Cette fonction ne doit pas être utilisée dans un  environnement  multi-
       threads.  La  routine  wcrtomb  fournit une meilleure interface pour la
       même fonctionnalité.

TRADUCTION

       Christophe Blaess, 1996-2003.