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(char dest[restrict .n], const wchar_t *restrict src,
                       size_t n);

DESCRIPTION
       Si dest n'est pas NULL, la fonction wcstombs() convertit la chaine de
       caracteres larges src en une sequence multioctet situee en dest. Au
       plus n octets seront ecrits dans dest. La sequence de caracteres ecrits
       dans dest debute dans l'etat de decalage initial. La conversion peut se
       terminer pour trois raisons :

       -  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').

       Le programmeur doit s'assurer qu'il y a assez de place pour au moins n
       octets dans dest.

       Si dest est NULL, la longueur n est ignoree, et la conversion se
       deroule comme precedemment, sauf que les octets convertis ne sont pas
       ecrits en memoire et qu'aucune limite de longueur n'existe en
       destination.

       Pour eviter le cas 2 ci-dessus, le programmeur doit s'assurer que n est
       superieur ou egal a 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.

STANDARDS
       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> et David Prevot
       <david@tilapin.org>

       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.06   31 octobre 2023                    wcstombs(3)