wcstombs(3)                Library Functions Manual                wcstombs(3)

NOM
       wcstombs - Convertir une chaine de caracteres larges en chaine de
       caracteres multioctets

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <stdlib.h>

       size_t wcstombs(size_t dsize;
                       char dest[restrict dsize], const wchar_t *restrict src,
                       size_t dsize);

DESCRIPTION
       If dest is not NULL, the wcstombs()  function converts the
       wide-character string src to a multibyte string starting at dest.  At
       most dsize bytes are written to dest.  The sequence of characters
       placed in dest begins in the initial shift state.  The conversion can
       stop for three reasons:

       -  Un caractere large que l'on ne peut pas representer par une sequence
          multioctet (dans la locale utilisee) a ete rencontre. Dans ce cas,
          la fonction renverra (size_t) -1.

       -  La limite de longueur force l'arret. Dans ce cas, le nombre d'octets
          ecrits dans dest est renvoye, mais l'etat de decalage a cet endroit
          est perdu.

       -  La chaine de caracteres larges a ete completement convertie, y
          compris le caractere large nul final (L'\0'). Dans ce cas, la
          conversion se termine dans l'etat de decalage initial. La fonction
          renvoie le nombre d'octets ecrits dans dest, sans compter l'octet
          nul final ('\0').

       The programmer must ensure that there is room for at least dsize bytes
       at dest.

       If dest is NULL, dsize is ignored, and the conversion proceeds as
       above, except that the converted bytes are not written out to memory,
       and no length limit exists.

       In order to avoid the case 2 above, the programmer should make sure
       dsize is greater than or equal to wcstombs(NULL,src,0)+1.

VALEUR RENVOYEE
       La fonction wcstombs() renvoie le nombre d'octets constituant la partie
       convertie d'une sequence multioctet, sans compter l'octet NULL final.
       Si elle rencontre un caractere large qu'elle ne peut convertir, elle
       renvoie (size_t) -1.

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

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |wcstombs()                       | Securite des threads     | MT-Safe |
       +---------------------------------+--------------------------+---------+
VERSIONS
       La fonction wcsrtombs(3) fournit une meilleure interface pour la meme
       fonctionnalite.

NORMES
       C11, POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, C99.

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

VOIR AUSSI
       mblen(3), mbstowcs(3), mbtowc(3), wcsrtombs(3), wctomb(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>, Gregoire Scano <gregoire.scano@malloc.fr> et Jean-
       Pierre Giraud <jean-pierregiraud@neuf.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>.

Pages du manuel de Linux 6.18  8 fevrier 2026                      wcstombs(3)