Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
mbstowcs - Convertir une chaine de caracteres multi-octets en une
chaine de caracteres larges
SYNOPSIS
#include <stdlib.h>
size_t mbstowcs(wchar_t *dest, const char *src, size_t n);
DESCRIPTION
Si dest n'est pas un pointeur NULL, la fonction mbstowcs() convertit la
chaine multi-octets src en chaine de caracteres larges dest. Elle
ecrira au plus n caracteres larges dans dest. L'etat de conversion est
initialise. La conversion peut s'arreter pour l'une des trois raisons
suivantes :
1. Une sequence multi-octets invalide a ete rencontree. Dans ce cas,
elle renvoie (size_t) -1.
2. n caracteres larges non nuls ont ete stockes dans dest. Dans ce cas,
le nombre de caracteres ecrits dans dest est renvoye, mais l'etat de
decalage en ce point est perdu.
3. La chaine multi-octets a ete completement convertie, y compris le
caractere nul final. Dans ce cas, le nombre de caracteres larges
ecrits dans dest, sans compter le caractere nul final, est renvoye.
Le programmeur doit s'assurer qu'il y a assez de place pour au moins n
caracteres larges dans dest.
Si dest est NULL, n est ignore, et la conversion se presente comme
au-dessus, excepte que les caracteres larges ne sont pas ecrits en
memoire et qu'aucune limite de longueur n'existe.
Afin d'eviter la situation numero 2 ci-dessus, le programmeur doit
s'assurer que n est superieur ou egal a mbstowcs(NULL,src,0)+1.
VALEUR RENVOY'EE
La fonction mbstowcs() renvoie le nombre de caracteres larges qui
constituent la partie convertie de la chaine, sans compter le caractere
nul final. Si une sequence multi-octets invalide est rencontree, elle
renvoie (size_t) -1.
CONFORMIT'E
C99.
NOTES
Le comportement de mbstowcs() depend de la categorie LC_CTYPE de la
localisation en cours.
La fonction mbsrtowcs(3) fournit une meilleure interface pour la meme
fonctionnalite.
VOIR AUSSI
mbsrtowcs(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). Florentin
Duneau 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> >>.