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

NOM

       wcsnrtombs  -  Convertir  une  chaine  de caracteres larges en sequence
       multioctet

SYNOPSIS

       #include <wchar.h>

       size_t wcsnrtombs(char *dest, const wchar_t **src, size_t nwc,
                         size_t len, mbstate_t *ps);

   Exigences de macros de test de fonctionnalites  pour  la  glibc  (consultez
   feature_test_macros(7)) :

       wcsnrtombs() :
           Depuis la glibc 2.10 :
               _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
           Avant la glibc 2.10 :
               _GNU_SOURCE

DESCRIPTION

       La  fonction wcsnrtombs() est l'equivalent de wcsrtombs(3), sauf que le
       nombre de  caracteres  larges  a  convertir  est  limite  (a  nwc),  en
       commencant en *src.

       Si  dest n'est pas un pointeur NULL, la fonction wcsnrtombs() convertit
       au maximum nwc caracteres larges depuis la chaine *src vers la sequence
       multioctet  situee en dest. Au plus len octets seront ecrits dans dest.
       L'etat de conversion *ps est mis a jour. La conversion est realisee  en
       fait  en  invoquant a repetition wcrtomb(dest,*src,ps), aussi longtemps
       que cet appel reussit, en augmentant  a  chaque  fois  dest  du  nombre
       d'octets  ecrits,  et  en incrementant *src de 1. 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 *src
       pointera sur le caractere invalide, et la fonction renverra (size_t) -1
       apres avoir place EILSEQ dans errno.

       2.  On  a  converti  nwc caracteres larges sans rencontrer L'\0', ou la
       limite len est atteinte. Dans ce cas, *src pointera  sur  le  caractere
       suivant  a  convertir, et la fonction renvoie le nombre d'octets ecrits
       dans dest.

       3. La chaine de caracteres  larges  a  ete  completement  convertie,  y
       compris  le  L'\0'  final (ramenant *ps a l'etat initial). Dans ce cas,
       *src devient NULL, et la fonction renvoie  le  nombre  d'octets  ecrits
       dans dest, sans compter l'octet '\0'.

       Si  dest  est  NULL,  la  longueur len 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.

       Dans tous les cas, si ps est un pointeur NULL, un etat statique anonyme
       propre a la fonction est utilise a la place.

       Le  programmeur  doit  s'assurer qu'il y a assez de place pour au moins
       len octets au minimum dans dest.

VALEUR RENVOY'EE

       La fonction wcsnrtombs 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 et place EILSEQ dans errno.

CONFORMIT'E

       Cette fonction est une extension GNU.

NOTES

       Le  comportement  de wcsnrtombs() depend de la categorie LC_CTYPE de la
       locale utilisee.

       L'utilisation d'un pointeur  NULL  pour  ps  n'est  pas  sure  dans  un
       contexte multithread.

VOIR AUSSI

       iconv(3), 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> >>.