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 un caractère
       large nul (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 est un caractère large nul (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 anonyme.

       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

       mbsinit(3), wcsrtombs(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> ».

GNU                                               18 mars 2014                                        WCRTOMB(3)