_mbclen, mblen, _mblen_l, _mbclen_l

Uzunluğu alır ve çok baytlı bir karakterin geçerliliğini belirler.

Önemli

Bu API, Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.

Sözdizimi

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

Parametreler

c
Çok baytlı karakter.

mbstr
Çok baytlı bayt bayt dizisinin adresi.

count
Denetlenecek bayt sayısı.

locale
Kullanılacak yerel ayar.

Dönüş değeri

_mbclen ve _mbclen_l çok baytlı karakterin cuzunluğuna göre 1 veya 2 döndürür. İşlevler, çok baytlı olsun veya olmasın c UTF-8 için her zaman 1 döndürür. için _mbclenhata döndürme yok.

NULLmblen değilse mbstr ve _mblen_l çok baytlı karakterin uzunluğunu bayt cinsinden döndürür. mblen ve _mblen_l işlevleri UTF-8 üzerinde düzgün çalışır ve 1 ile 3 arasında bir değer döndürebilir. olduğunda mbstrNULL (veya geniş karakterli null karaktere işaret eder) mblen ve _mblen_l 0 döndürür. İşaret eden mbstr nesnenin ilk count karakterler içinde geçerli bir çok baytlı karakter oluşturması veya mblen_mblen_l -1 döndürmesi gerekir.

Açıklamalar

_mbclen işlevi, çok baytlı karakterinin cuzunluğunu bayt cinsinden döndürür. Çok c baytlı bir karakterin baş baytını göstermiyorsa (örtük bir çağrı _ismbbleadtarafından belirlendiği gibi) sonucu _mbclen tahmin edilemez.

mblen geçerli bir çok baytlı karakterse bayt mbstr cinsinden uzunluğu döndürür. Ayrıca kod sayfasıyla ilişkili çok baytlı karakter geçerliliğini de belirler. mblencount içinde yer alan mbstrancak bayttan MB_CUR_MAX fazla olmayan veya daha az bayt inceler.

Çıkış değeri, yerel ayarın LC_CTYPE kategori ayarından etkilenir. Bu işlevlerin son eki olmayan _l sürümleri, bu yerel ayara bağımlı davranış için geçerli yerel ayarı kullanır. Son _l ekli sürümler aynı şekilde davranır, ancak bunun yerine geçirilen yerel ayar parametresini kullanır. Daha fazla bilgi için bkz setlocale . ve Yerel Ayar.

_mbclen, _mblen_lve _mbclen_l Standart C kitaplığının parçası değil, Microsoft'a özeldir. Bunları taşınabilir kod istediğiniz yerde kullanmanızı önermeyiz. Standart C uyumluluğu için veya mbrlen kullanınmblen.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

Tchar.h yordamı	_UNICODE ve _MBCS tanımlanmadı	_MBCS Tanımlanan	_UNICODE Tanımlanan
_tclen	Makroya veya satır içi işleve Haritalar	_mbclen	Makroya veya satır içi işleve Haritalar

Gereksinimler

Yordam	Gerekli başlık
_mbclen	<mbstring.h>
mblen	<stdlib.h>
_mblen_l	<stdlib.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

// 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

Ayrıca bkz.

Karakter sınıflandırması
Yerel ayar
Çok baytlı karakter dizilerinin yorumlanması
_mbccpy, _mbccpy_l
mbrlen
strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l