Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
NOM
mbsnrtowcs - Convertir une sequence multi-octets en chaine de
caracteres larges
SYNOPSIS
#include <wchar.h>
size_t mbsnrtowcs(wchar_t *dest, const char **src,
size_t nms, size_t len, mbstate_t *ps);
Exigences de macros de test de fonctionnalites pour la glibc (consultez
feature_test_macros(7)) :
mbsnrtowcs() :
Depuis la glibc 2.10 :
_XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
Avant la glibc 2.10 :
_GNU_SOURCE
DESCRIPTION
La fonction mbsnrtowcs() est equivalente a la fonction mbsrtowcs(3),
sauf qu'elle ne convertit qu'un nombre limite (a nms) d'octets
commencant en *src.
Si dest n'est pas un pointeur NULL, la fonction mbsnrtowcs() convertit
au plus nms octets depuis la sequence multi-octets *src en une chaine
de caracteres larges situee dans dest. Au maximum len caracteres larges
sont ecrits dans dest. L'etat de conversion *ps est mis a jour. La
conversion est en fait realisee en invoquant de facon repetee
mbrtowc(dest, *src, n, ps), ou n est un nombre positif, aussi longtemps
que l'appel reussit, puis en incrementant dest de un et en augmentant
*src du nombre d'octets lus. La conversion peut s'arreter pour trois
raisons :
1. Une sequence multi-octets invalide a ete rencontree. Dans ce cas,
*src pointera sur la sequence invalide, et la fonction renvoie
(size_t) -1 en positionnant errno a la valeur EILSEQ.
2. L'arret est force a cause de la limite nms, ou si len caracteres
larges differents de L'\0' ont ete enregistres en dest. Dans ce cas,
*src pointe sur la sequence multi-octets suivante, et le nombre de
caracteres larges ecrits dans dest est renvoye.
3. La sequence multi-octets a ete completement convertie, y compris le
'\0' final (ce qui a pour effet de bord de ramener *ps a l'etat
initial). Dans ce cas, *src est mis a NULL, et le nombre de
caracteres ecrits dans dest, moins le L'\0' final, est renvoye.
Si dest est NULL, alors len est ignore, et la conversion se deroule
comme precedemment, sauf que les caracteres convertis ne sont pas
ecrits en memoire, et qu'aucune limite de destination n'est prise en
compte.
Dans tous les cas, si ps est un pointeur NULL, un etat anonyme
statique, reserve a la fonction mbsnrtowcs est utilise a sa place.
Le programmeur doit s'assurer qu'il y assez de place pour au moins len
caracteres larges dans dest.
VALEUR RENVOY'EE
La fonction mbsnrtowcs() renvoie le nombre de caracteres larges places
dans la zone convertie, sans compter le caractere nul final. Si une
sequence multi-octets invalide est rencontree, la fonction renvoie
(size_t) -1, et errno contient EILSEQ.
CONFORMIT'E
Cette fonction est une extension GNU.
NOTES
Le comportement de mbsnrtowcs() depend de la categorie LC_CTYPE de la
localisation en cours.
L'utilisation d'un pointeur NULL pour ps n'est pas sure dans un
contexte multithread.
VOIR AUSSI
iconv(3), 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> >>.