_mbclen、mblen、_mblen_l

長さを取得し、マルチバイト文字の有効性を決定します。

重要
この API は、Windows のランタイムで実行するアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。

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

パラメーター

• c
  マルチバイト文字。

• mbstr
  マルチバイト文字のバイト シーケンスのアドレス。

• count
  チェックするバイト数。

• locale
  使用するロケール。

戻り値

_mbclen はマルチバイト文字 c の長さが 1 バイトまたは 2 バイトであるかによって、1 または 2 を返します。_mbclenのエラーの戻り値はありません。mbstr が NULLである mblen は、長さが、マルチバイト文字のサイズをバイト単位で返します。mbstr が NULL であるかまたはワイド文字の null 文字をポイントすると、mblen は 0 を返します。mbstr が指すオブジェクトが count の最初の文字内の有効なマルチバイト文字を構成して、mblen は–1 を返します。

解説

_mbclen 関数は、長さが、マルチバイト文字 cのサイズをバイト単位で返します。c が _ismbbleadに暗黙の呼び出しによって決定されるマルチバイト文字の先行バイトを指して、_mbclen の結果は予測できません。

mblen は、有効なマルチバイト文字の場合はを返し、コード ページに関連付けられているマルチバイト文字の有効性を決定します mbstr のバイトを長さ。mblen は mbstrに含まれる count、いくつかのバイト MB_CUR_MAX バイトの詳細はチェックされません。

出力値は、ロケールの LC_CTYPE カテゴリの設定で決まります。詳細については、「setlocale」を参照してください。_l サフィックスが付いていないこの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。詳細については、「ロケール」を参照してください。

汎用テキスト ルーチンのマップ

必要条件

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

使用例

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

同等の .NET Framework 関数

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

文字分類

ロケール

マルチバイト文字のシーケンスの解釈

_mbccpy、_mbccpy_l

strlen、strlen_l、wcslen、wcslen_l、_mbslen、_mbslen_l、_mbstrlen、_mbstrlen_l