NOM

       wcsrtombs - Convertir une chaîne de caractères larges en séquence multioctet

SYNOPSIS

       #include <wchar.h>

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

DESCRIPTION

       Si  dest  n'est  pas  un  pointeur  NULL, la fonction wcsrtombs() convertit les caractères
       larges depuis la chaîne *src vers la séquence multioctet  située  en  dest.  Au  plus  len
       octets seront écrits dans dest. L'état de conversion *ps est mis à jour. La conversion est
       réalisée en invoquant wcrtomb(dest,*src,ps) aussi longtemps  que  cet  appel  réussit,  en
       augmentant  à  chaque  fois  dest  du  nombre d'octets écrits, et en incrémentant *src. La
       conversion peut se terminer pour trois raisons :

       1. Un caractère large que l'on ne peut pas représenter par une séquence  multioctet  (dans
       la  locale utilisée) a été rencontré. Dans ce cas *src pointera sur le caractère invalide,
       et la fonction renverra (size_t) -1 après avoir placé EILSEQ dans errno.

       2. La limite len est atteinte. Dans ce cas  *src  pointera  sur  le  caractère  suivant  à
       convertir, et la fonction renvoie le nombre d'octets écrits dans dest.

       3.  La  chaîne  de  caractères larges a été complètement convertie, y compris le caractère
       large nul final (« L'\0' »), ramenant *ps à l'état initial.  Dans  ce  cas,  *src  devient
       NULL, et la fonction renvoie le nombre d'octets écrits dans dest, sans compter l'octet nul
       (« '\0' ») final.

       Si dest est NULL, la  longueur  len  est  ignorée,  et  la  conversion  se  déroule  comme
       précédemment,  sauf que les octets convertis ne sont pas écrits en mémoire, et qu'il n'y a
       pas de limite de longueur en destination.

       Dans tous les cas, si ps est un pointeur NULL, un état  anonyme  statique,  réservé  à  la
       fonction mbsnrtowcs() est utilisé à sa place.

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

VALEUR RENVOYÉE

       La fonction wcsrtombs() renvoie le nombre d'octets constituant la partie convertie  de  la
       séquence  multioctet, sans compter l'octet nul final. Si elle rencontre un caractère large
       qu'elle ne peut convertir, elle renvoie (size_t) -1 et place EILSEQ dans errno.

CONFORMITÉ

       C99.

NOTES

       Le comportement de wcsrtombs() dépend de la catégorie LC_CTYPE de la locale utilisée.

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

VOIR AUSSI

       iconv(3), wcsnrtombs(3), wcstombs(3)

COLOPHON

       Cette page fait partie de la publication 3.57 du projet man-pages Linux.  Une  description
       du  projet  et  des  instructions  pour  signaler  des  anomalies  peuvent être trouvées à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis   2010,   cette   traduction   est   maintenue   à   l'aide   de    l'outil    po4a
       <http://po4a.alioth.debian.org/>  par l'équipe de traduction francophone au sein du projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe   Blaess   <http://www.blaess.fr/christophe/>   (1996-2003),    Alain    Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Nicolas  François  et  l'équipe francophone de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».