Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

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> >>.