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

NOM

       mbrlen - Calculer la longueur d'un caractere multi-octets

SYNOPSIS

       #include <wchar.h>

       size_t mbrlen(const char *s, size_t n, mbstate_t *ps);

DESCRIPTION

       La  fonction  mbrlen()  examine  au  maximum  n  octets  de la sequence
       commencant en  s  et  en  extrait  le  caractere  multi-octets  complet
       suivant.  Elle  met  a  jour  l'etat  de  decalage *ps. Si le caractere
       multi-octets ne correspond pas au caractere large nul, elle renvoie  le
       nombre  d'octets  qui ont ete lus dans s. Si ce caractere correspond au
       caractere large nul, elle reinitialise l'etat *ps et renvoie 0.

       Si les n octets  commencant  en  s  ne  contiennent  pas  un  caractere
       multi-octets  complet,  mbrlen()  renvoie  (size_t) -2.  Ceci  peut  se
       produire  meme  si  n  >=  MB_CUR_MAX,  dans  le  cas  ou  la  sequence
       multi-octets contient des sequences de decalage redondantes.

       Si  la  sequence  multi-octets  commencant  en  s contient une sequence
       invalide  avant  le  prochain  caractere  complet,   mbrlen()   renvoie
       (size_t) -1  et  place  dans  errno  la valeur EILSEQ. Dans ce cas, les
       effets sur *ps sont indefinis.

       Si ps est un pointeur NULL, une zone de  memoire  statique  reservee  a
       mbrlen() est utilisee a sa place.

VALEUR RENVOY'EE

       La  fonction  mbrlen()  renvoie  le  nombre  d'octets balayes depuis la
       sequence commencant en s, si un caractere large non nul a ete  reconnu.
       Elle renvoie zero si un caractere large nul est rencontre. Elle renvoie
       (size_t) -1 et remplit errno avec EILSEQ, si une sequence invalide  est
       trouvee.  Elle  renvoie (size_t) -2 si elle n'a pas trouve de caractere
       entier, et si n doit etre augmente.

CONFORMIT'E

       C99.

NOTES

       Le comportement de mbrlen() depend  de  la  categorie  LC_CTYPE  de  la
       localisation en cours.

VOIR AUSSI

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