NOM¶
wctomb - Convertir un caractère large en séquence multioctet
SYNOPSIS¶
#include <stdlib.h>
int wctomb(char *s, wchar_t wc);
DESCRIPTION¶
Si
s n'est pas NULL, la fonction
wctomb() convertit le
caractère large
wc dans sa représentation multioctet et
le stocke au début de la chaîne de caractères
pointée par
s. Elle met à jour l'état de
décalage, variable statique anonyme connue uniquement
d'elle-même, et renvoie la longueur de la représentation
multioctet, c'est-à-dire le nombre d'octets écrits dans
s.
Le programmeur doit s'assurer qu'il y a assez de place pour au moins
MB_CUR_MAX octets au moins dans
s.
Si
s est NULL, la fonction
wctomb() réinitialise
l'état de décalage, connu seulement de cette fonction, à
sa valeur initiale et renvoie une valeur non nulle si l'encodage a un
état de décalage non trivial, ou zéro si l'encodage est
sans état.
VALEUR RENVOYÉE¶
Si
s n'est pas NULL, la fonction
wctomb() renvoie le nombre
d'octets qui ont été écrits dans le tableau d'octets
à l'adresse
s. Si
wc ne peut pas être
représenté par une séquence multioctet (d'après la
locale utilisée), elle renvoie -1.
Si
s est NULL, la fonction
wctomb() renvoie une valeur non nulle
si l'encodage a un état de décalage non trivial, ou zéro
si l'encodage est sans état.
ATTRIBUTS¶
Multithreading (voir pthreads(7))¶
La fonction
wctomb() n'est pas sûre dans un contexte multithread.
C99.
NOTES¶
Le comportement de
wctomb() dépend de la catégorie
LC_CTYPE de la locale utilisée.
La fonction
wcrtomb(3) fournit une meilleure interface pour la
même fonctionnalité.
VOIR AUSSI¶
MB_CUR_MAX(3),
mblen(3),
mbstowcs(3),
mbtowc(3),
wcrtomb(3),
wcstombs(3)
COLOPHON¶
Cette page fait partie de la publication 3.65 du projet
man-pages Linux.
Une description du projet et des instructions pour signaler des anomalies
peuvent être trouvées à l'adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<
http://po4a.alioth.debian.org/> par l'équipe de traduction
francophone au sein du projet perkamon
<
http://perkamon.alioth.debian.org/>.
Christophe Blaess <
http://www.blaess.fr/christophe/> (1996-2003), Alain
Portal <
http://manpagesfr.free.fr/> (2003-2006). Nicolas François
et l'équipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet
manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce
document en utilisant la commande «
man -L C
<section>
<page_de_man> ».