MBSTOWCS
Section : Manuel du programmeur Linux (
3)
Mise à jour de la version anglaise : 25 juillet 1999
Index
Menu principal
NOM
mbstowcs - Convertir une chaîne de caractères multi-octets en une chaîne de caractères 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 chaîne multi-octets
src
en chaîne de caractères larges
dest.
Elle écrira au plus
n
caractères larges dans
dest.
L'état de conversion est initialisé.
La conversion peut s'arrêter pour l'une des trois raisons suivantes :
- 1.
-
Une séquence multi-octets invalide a été rencontrée.
Dans ce cas, elle renvoie
(size_t) -1.
- 2.
-
n
caractères larges non nuls ont été stockés dans
dest.
Dans ce cas, le nombre de caractères écrits dans
dest
est renvoyé, mais l'état de décalage en ce point est perdu.
- 3.
-
La chaîne multi-octets a été complètement convertie,
y compris l'octet nul final.
Dans ce cas, le nombre de caractères larges écrits dans
dest,
sans compter l'octet nul final, est renvoyé.
Le programmeur doit s'assurer qu'il y a assez de place pour au moins
n
caractères larges dans
dest.
Si
dest
est
NULL,
n
est ignoré, et la conversion se présente comme au-dessus,
excepté que les caractères larges ne sont pas écrits en mémoire
et qu'aucune limite de longueur n'existe.
Afin d'éviter la situation numéro 2 ci-dessus,
le programmeur doit s'assurer que
n
est supérieur ou égal a
mbstowcs(NULL,src,0)+1.
VALEUR RENVOYÉE
La fonction
mbstowcs()
renvoie le nombre de caractères larges qui constituent
la partie convertie de la chaîne, sans compter l'octet nul final.
Si une séquence multi-octets invalide est rencontrée,
elle renvoie
(size_t) -1.
CONFORMITÉ
C99.
NOTES
Le comportement de
mbstowcs()
dépend de la catégorie
LC_CTYPE
des paramètres régionaux en vigueur.
La fonction
mbsrtowcs(3)
fournit une meilleure interface pour la même fonctionnalité.
VOIR AUSSI
mbsrtowcs(3)
TRADUCTION
Ce document est une traduction réalisée par Christophe Blaess
<http://www.blaess.fr/christophe/> le 4 novembre 1996
et révisée le 17 juillet 2008.
L'équipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité. La version anglaise la plus à jour de ce document est
toujours consultable via la commande : « LANG=C man 3 mbstowcs ».
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- CONFORMITÉ
-
- NOTES
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 17 juillet 2008