Provided by: manpages-fr-dev_2.64.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 routine 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)

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