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

NOM

       wcrtomb - Convertir un caractère large en séquence 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 où s est non NULL, et wc n'est pas
       L'\0'. Alors, la fonction wcrtomb() convertit le caractère large wc dans sa représentation
       multioctet, et l'enregistre au début de la chaîne pointée par s. Elle met à jour l'état de
       conversion *ps, et renvoie la longueur de la représentation  multioctet,  c'est-à-dire  le
       nombre d'octets écrits en s.

       Une  autre  possibilité  peut  se présenter quand s est non NULL, mais wc vaut L'\0'. Dans
       cette situation, la fonction wcrtomb() enregistre dans la chaîne de caractères pointée par
       s  la  séquence  de  décalages nécessaire pour ramener *ps à son état initial, suivie d'un
       octet '\0'. Elle met à jour l'état *ps (le ramène donc à l'état initial),  et  renvoie  la
       longueur  de  la séquence en ajoutant un pour compter le caractère nul final, c'est-à-dire
       le nombre d'octets écrits dans s.

       Un troisième cas se présente quand s est NULL.  Alors,  wc  est  ignoré,  et  la  fonction
       renvoie alors le résultat de wcrtomb(tampon,L'\0',ps) où tampon est un tampon interne.

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

VALEUR RENVOYÉE

       La fonction wcrtomb() renvoie le nombre d'octets qui ont été  -  ou  qui  auraient  été  -
       écrits  dans  le  tableau d'octets s. Si wc ne peut pas être représenté comme une séquence
       multioctet (dans la locale en cours), elle  renvoie  (size_t) -1,  et  place  EILSEQ  dans
       errno.

CONFORMITÉ

       C99.

NOTES

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

       L'utilisation d'un pointeur NULL pour ps n'est pas sûre 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  être  trouvées  à
       l'adresse <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <URL:http://po4a.alioth.debian.org/> par l'équipe 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 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> ».