wcrtomb(3)                 Library Functions Manual                 wcrtomb(3)

NOM
       wcrtomb - Convertir un caractere large en sequence multioctet

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <wchar.h>

       size_t wcrtomb(char *restrict s, wchar_t wc, mbstate_t *restrict ps);

DESCRIPTION
       L'utilisation principale de cette fonction est le cas ou s est non
       NULL, et wc n'est pas un caractere large nul (L'\0'). Alors, la
       fonction wcrtomb() convertit le caractere large wc a sa representation
       multioctet et l'enregistre au debut de la chaine pointee par s. Elle
       met a jour l'etat de conversion *ps et renvoie la longueur de la
       representation multioctet, c'est-a-dire le nombre d'octets ecrits en s.

       Une autre possibilite peut se presenter quand s est non NULL, mais wc
       est un caractere large nul (L'\0'). Dans cette situation, la fonction
       wcrtomb() enregistre dans la chaine de caracteres pointee par s la
       sequence de decalages necessaire pour ramener *ps a son etat initial,
       suivie d'un octet '\0'. Elle met a jour l'etat *ps (le ramene donc a
       l'etat initial), et renvoie la longueur de la sequence en ajoutant un
       pour compter le caractere nul final, c'est-a-dire le nombre d'octets
       ecrits dans s.

       Un troisieme cas se presente quand s est NULL. Alors, wc est ignore, et
       la fonction renvoie alors le resultat de

           wcrtomb(tampon, L'\0', ps)

       ou tampon est un tampon interne anonyme.

       Dans tous les cas ci-dessus, si ps est NULL, un etat statique interne
       qui n'est connu que de la fonction wcrtomb() est utilise a la place.

       At most MB_CUR_MAX bytes will be written at s.  The programmer must
       ensure that there is enough room to store the multibyte sequence at s.

VALEUR RENVOYEE
       La fonction wcrtomb() renvoie le nombre d'octets qui ont ete - ou qui
       auraient ete - ecrits dans le tableau d'octets s. Si wc ne peut pas
       etre represente comme une sequence multioctet (dans la locale en
       cours), elle renvoie (size_t) -1 et place EILSEQ dans errno.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +--------------+--------------------------+----------------------------+
       |Interface     | Attribut                 | Valeur                     |
       +--------------+--------------------------+----------------------------+
       |wcrtomb()     | Securite des threads     | MT-Unsafe race:wcrtomb/!ps |
       +--------------+--------------------------+----------------------------+
NORMES
       C11, POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, C99.

NOTES
       Le comportement de wcrtomb() depend de la categorie LC_CTYPE de la
       locale utilisee.

       Passer NULL dans ps n'est pas sur dans un contexte multithread.

VOIR AUSSI
       mbsinit(3), wcsrtombs(3)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Jean-Baptiste Holcroft <jean-baptiste@holcroft.fr>
       et Gregoire Scano <gregoire.scano@malloc.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Linux man-pages 6.18           8 fevrier 2026                       wcrtomb(3)