Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
wcrtomb - Convertir un caractere large en sequence 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 ou s est non
NULL, et wc n'est pas L'\0'. Alors, la fonction wcrtomb() convertit le
caractere large wc dans 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
vaut 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.
Dans tous les cas ci-dessus, si ps est un pointeur NULL, un etat
statique interne est utilise a la place, qui n'est connu que de la
fonction wcrtomb().
VALEUR RENVOY'EE
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.
CONFORMIT'E
C99.
NOTES
Le comportement de wcrtomb() depend de la categorie LC_CTYPE de la
locale utilisee.
L'utilisation d'un pointeur NULL pour ps n'est pas sure dans un
contexte multithread.
VOIR AUSSI
wcsrtombs(3)
COLOPHON
Cette page fait partie de la publication 3.27 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Nicolas
Francois et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.