Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
wcstombs - Convertir une chaine de caracteres etendus en chaine de
caracteres multioctet
SYNOPSIS
#include <stdlib.h>
size_t wcstombs(char *dest, const wchar_t *src, size_t n);
DESCRIPTION
Si dest n'est pas un pointeur NULL, la fonction wcstombs() convertit la
chaine de caracteres larges src vers la sequence multioctet situee en
dest. Au plus n octets seront ecrits dans dest. La conversion debute
dans l'etat initial. La conversion peut se terminer pour trois
raisons :
1. 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.
2. La limite de longueur force l'arret. Dans ce cas, le nombre d'octets
ecrits dans dest est renvoye, mais l'etat de decalage est perdu.
3. La chaine de caracteres larges a ete completement convertie, y
compris le L'\0' final. Dans ce cas, la conversion se termine dans
l'etat initial. La fonction renvoie le nombre d'octets ecrits dans
dest, sans compter l'octet '\0' final.
Le programmeur doit s'assurer qu'il y a assez de place pour au moins n
octets au minimum 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'il n'y a pas de limite de longueur 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 RENVOY'EE
La fonction wcstombs() renvoie le nombre d'octets constituant la partie
convertie de la sequence multioctet, sans compter l'octet nul final. Si
elle rencontre un caractere large qu'elle ne peut convertir, elle
renvoie (size_t) -1.
CONFORMIT'E
C99.
NOTES
Le comportement de wcstombs() depend de la categorie LC_CTYPE de la
locale utilisee.
La fonction wcsrtombs(3) fournit une interface sure en contexte
multithread pour la meme fonctionnalite.
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> >>.