Provided by: manpages-fr-dev_3.17.1-1_all bug

NOM

       mblen - Déterminer la taille du prochain caractère multi-octets

SYNOPSIS

       #include <stdlib.h>

       int mblen(const char *s, size_t n);

DESCRIPTION

       Si s n’est pas un pointeur NULL, la fonction mblen() inspecte au plus n
       octets de la chaîne multi-octets commençant à l’adresse s et extrait le
       caractère  multi-octets  complet  suivant.  Elle  utilise  un  état  de
       décalage statique anonyme,  uniquement connu de la fonction mblen(). Si
       le  caractère  multi-octets  n’est  pas  le  caractère  large nul, elle
       renvoie le nombre d’octets consommés de s. Si c’est le caractère  large
       nul, elle renvoie 0.

       Si  les  n  octets  commençant  à  l’adresse  s  ne  contiennent pas un
       caractère multi-octets complet, mblen() renvoie -1. Ceci  peut  arriver
       même si n est supérieur ou égal à MB_CUR_MAX, si la chaîne multi-octets
       contient des séquences de décalages redondantes.

       Si la  chaîne  multi-octets  commençant  en  s  contient  une  séquence
       invalide avant le prochain caractère complet, mblen() renvoie aussi -1.

       Si s est un pointeur NULL, la fonction mblen() ré-initialise l’état  de
       décalage  (connue  d’elle seule), et renvoie une valeur non nulle si le
       codage a un état de décalage non trivial, ou zéro si le codage est sans
       état.

VALEUR RENVOYÉE

       La  fonction  mblen()  renvoie  le  nombre  d’octets  analysés  dans la
       séquence multi-octets commençant en s, si un caractère large non nul  a
       été reconnu. Elle renvoie zéro, si un caractère large nul a été trouvé.
       Elle renvoie -1 si une séquence multi-octets invalide ou  un  caractère
       multi-octets incomplet a été rencontrés.

CONFORMITÉ

       C99.

NOTES

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

       La fonction mbrlen(3) fournit une  meilleure  interface  pour  la  même
       fonctionnalité.

VOIR AUSSI

       mbrlen(3)

COLOPHON

       Cette  page  fait  partie  de  la  publication 3.17 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

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
       francophone de traduction de Debian.

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