_mbclen, mblen, _mblen_l

Article
06/09/2015

Obtient la longueur et détermine la validité d'un caractère multi-octets.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans le Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

size_t _mbclen(
   const unsigned char *c 
);
int mblen(
   const char *mbstr,
   size_t count 
);
int _mblen_l(
   const char *mbstr,
   size_t count,
   _locale_t locale
);

Paramètres

c
Caractère multi-octets
mbstr
Adresse d'une séquence d'octets à caractères multi-octets.
count
Nombre d'octets à vérifier.
locale
Paramètres régionaux à utiliser.

Valeur de retour

_mbclen retourne 1 ou 2, selon que le caractère multi-octets c fait 1 ou 2 octets. Pas d'erreur retournée pour _mbclen. Si mbstr n'est pas NULL, mblen retourne la longueur, en octets, du caractère multi-octets. Si mbstr est NULL ou il point vers le caractère Null à caractère large, mblen retourne 0. Si l'objet vers lequel mbstr pointe ne constitue pas un caractère multi-octets valide dans les premiers caractères count, mblen retourne – 1.

Notes

La fonction _mbclen retourne la longueur, en octets, du caractère multi-octets c. Si c n'affiche pas l'octet de tête d'un caractère multi-octets déterminé par un appel implicite à _ismbblead, le résultat de _mbclen est imprévisible.

mblen retourne la longueur en octets de mbstr si c'est un caractère multi-octets valide et détermine la validité du caractère multi-octets associée à la page de codes. mblen examine count ou moins d'octets contenus dans mbstr, mais pas plus que les octets MB_CUR_MAX.

La valeur de la sortie est affectée par la valeur du paramètre de la catégorie LC_CTYPE des paramètres régionaux ; consultez setlocale, pour plus d'informations. Les versions de ces fonctions sans le suffixe _l utilisent les paramètres régionaux pour ce comportement dépendant des paramètres régionaux ; les versions avec le suffixe _l sont identiques, sauf qu'elles utilisent à la place les paramètres régionaux transmis. Pour plus d'informations, consultez Paramètres régionaux.

Mappages de routines de texte générique

Routine Tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_tclen	Mappe à la macro ou à la fonction inline	_mbclen	Mappe à la macro ou à la fonction inline

Configuration requise

Routine	En-tête requis
_mbclen	<mbstring.h>
mblen	<stdlib.h>
_mblen_l	<stdlib.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité.

Exemple

// crt_mblen.c
/* illustrates the behavior of the mblen function
 */

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
    int      i;
    char    *pmbc = (char *)malloc( sizeof( char ) );
    wchar_t  wc   = L'a';

    printf( "Convert wide character to multibyte character:\n" );
    wctomb_s( &i, pmbc, sizeof(char), wc );
    printf( "  Characters converted: %u\n", i );
    printf( "  Multibyte character: %x\n\n", *pmbc );

    i = mblen( pmbc, MB_CUR_MAX );
    printf( "Length in bytes of multibyte character %x: %u\n", *pmbc, i );

    pmbc = NULL;
    i = mblen( pmbc, MB_CUR_MAX );
    printf( "Length in bytes of NULL multibyte character %x: %u\n", pmbc, i );
}

Sortie

Convert wide character to multibyte character:
  Characters converted: 1
  Multibyte character: 61

Length in bytes of multibyte character 61: 1
Length in bytes of NULL multibyte character 0: 0