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.

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 |
       +--------------+--------------------------+----------------------------+
STANDARDS
       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>.

Pages du manuel de Linux 6.06   31 octobre 2023                     wcrtomb(3)