NOM

       mbrtowc - Convertir une séquence multioctet en caractère large

SYNOPSIS

       #include <wchar.h>

       size_t mbrtowc(wchar_t *pwc, const char *s, size_t n, mbstate_t *ps);

DESCRIPTION

       L'utilisation  principale  de  cette  fonction est avec s et pwc non NULL. Dans ce cas, la
       fonction mbrtowc() examine au plus n octets de la chaîne multioctet commençant  en  s,  en
       extrait  le  prochain  caractère  multioctet complet, et le place en *pwc. Elle met à jour
       l'état de décalage *ps. Si le caractère large obtenu n'est pas L'\0' (le  caractère  large
       nul), elle renvoie le nombre d'octets consommés depuis s. Si le caractère large obtenu est
       L'\0', elle réinitialise l'état de décalage *ps et renvoie zéro.

       Si les n octets commençant en s ne contiennent pas de caractère large  complet,  mbrtowc()
       renvoie  (size_t) -2.  Cela  peut se produire même si n >= MB_CUR_MAX, lorsque la séquence
       multioctet contient des séquences de décalage redondantes.

       Si la séquence multioctet commençant en s contient une séquence invalide avant le prochain
       caractère  complet,  mbrtowc()  renvoie  (size_t) -1 et place dans errno la valeur EILSEQ.
       Dans ce cas, les effets sur *ps sont indéfinis.

       Une autre situation est possible, si s est non NULL, mais  pwc  est  NULL.  Dans  ce  cas,
       mbrtowc() se comporte comme précédemment, mais n'enregistre pas le caractère large obtenu.

       Un  troisième  cas  se  présente si s est NULL. Alors, pwc et n sont ignorés. Si l'état de
       conversion représenté par *ps indique une conversion multioctet  incomplète,  la  fonction
       mbrtowc()  renvoie  (size_t) -1,  remplie  errno  avec  EILSEQ, et laisse *ps dans un état
       indéfini. Sinon, la fonction mbrtowc() replace *ps dans l'état initial et renvoie 0.

       Dans tous ces cas, si ps est un pointeur NULL, une  zone  de  mémoire  statique  propre  à
       mbrtowc()  est utilisée à sa place. Sinon, *ps doit être un objet mbstate_t valide. Un tel
       objet mbstate_t noté a peut être initialisé en le mettant à zéro, par exemple ainsi :

           memset(&a, 0, sizeof(a));

VALEUR RENVOYÉE

       La fonction mbrtowc() renvoie le nombre d'octets balayés depuis la séquence commençant  en
       s,  si  un  caractère large non nul a été reconnu. Elle renvoie zéro si un caractère large
       nul est rencontré. Elle renvoie (size_t) -1 et remplit errno avec EILSEQ, si une  séquence
       invalide est trouvée. Elle renvoie (size_t) -2 si elle n'a pas trouvé de caractère entier,
       et si n doit être augmenté.

ATTRIBUTS

   Multithreading (voir pthreads(7))
       La fonction mbrtowc() est sûre dans un contexte multithread avec  exceptions.  Elle  n’est
       pas sûre dans un contexte multithread si appelées avec un paramètre ps NULL.

CONFORMITÉ

       C99.

NOTES

       Le comportement de mbrtowc() dépend de la catégorie LC_CTYPE de la localisation en cours.

VOIR AUSSI

       mbsrtowcs(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). Florentin  Duneau  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> ».