_mbclen, , mblen_mblen_l_mbclen_l

Ruft die Länge ab und bestimmt die Gültigkeit eines Multibytezeichens.

Syntax

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

Parameter

c
Multibytezeichen.

mbstr
Adresse einer Multibytezeichen-Bytesequenz.

count
Anzahl zu überprüfender Bytes.

locale
Zu verwendendes Gebietsschema.

Rückgabewert

_mbclen und _mbclen_l gibt 1 oder 2 gemäß der Länge des Multibyte-Zeichens czurück. Die Funktionen geben immer 1 für UTF-8 zurück, unabhängig davon, ob c es sich um Multibyte handelt. Es wird kein Fehler zurückgegeben für _mbclen.

Ist mbstr dies nicht NULLmblen der Fehler, und _mblen_l geben Sie die Länge des Multibyte-Zeichens in Byte zurück. Die mblen Funktionen funktionieren _mblen_l ordnungsgemäß in UTF-8 und können einen Wert zwischen 1 und 3 zurückgeben. Ist mbstr der NULL Wert (oder zeigt es auf das zeichenweite Nullzeichen) mblen und _mblen_l gibt "0" zurück. Das Objekt, auf das verweist, mbstr muss innerhalb der ersten count Zeichen ein gültiges Multibytezeichen bilden oder mblen _mblen_l -1 zurückgeben.

Hinweise

Die _mbclen-Funktion gibt die Länge des Multibytezeichens c in Byte zurück. Wenn c nicht auf das Leadbytebyte-Byte eines Multibyte-Zeichens zeigt (wie durch einen impliziten Aufruf _ismbbleadbestimmt, ist das Ergebnis _mbclen unvorhersehbar.

mblen gibt die Länge in Byte zurück, wenn mbstr es sich um ein gültiges Multibytezeichen handelt. Außerdem wird die Gültigkeit von Multibyte-Zeichen bestimmt, die der Codepage zugeordnet ist. mblen untersucht count oder weniger Byte, die in mbstr enthalten sind, jedoch nicht mehr als MB_CUR_MAX Byte.

Der Ausgabewert wird von der LC_CTYPE Kategorieeinstellung des Gebietsschemas beeinflusst. Die Versionen dieser Funktionen ohne das _l-Suffix verwenden das aktuelle Gebietsschema für dieses gebietsschemaabhängiges Verhalten. Die _l suffixierten Versionen verhalten sich gleich, verwenden aber stattdessen den gebietsschemaparameter, der übergeben wird. Weitere Informationen finden Sie unter setlocale " Gebietsschema".

_mbclen, _mblen_lund _mbclen_l sind Microsoft-spezifisch, nicht Teil der Standard-C-Bibliothek. Es wird nicht empfohlen, sie an der Stelle zu verwenden, an der Sie portablen Code benötigen. Verwenden Oder mbrlen verwenden Sie mblen stattdessen die Standard-C-Kompatibilität.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

Anforderungen

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

// 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 );
}

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

Siehe auch

Zeichenklassifizierung
Gebietsschema
Interpretation von Multibytezeichensequenzen
_mbccpy, _mbccpy_l
mbrlen
strlen, , wcslen_mbslen, _mbslen_l, , _mbstrlen_mbstrlen_l