Provided by: manpages-fr_1.67.0-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 chaine commençant à l’adresse s et  extrait  le  caractère
       multi-octets  suivant.  Elle  utilise  un  état de décalage statique et
       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’octes consommés dans 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  à  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  prochaine caractère complet, mblen() renvoie aussi
       -1.

       Si s est un pointeur NULL, la fonction mblen() reinitialise  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 ont été rencontrés.

CONFORMITÉ

       ISO/ANSI C, UNIX98

VOIR AUSSI

       mbrlen(3)

NOTES

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

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

TRADUCTION

       Christophe Blaess, 1996-2003.