_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 の長さをバイト単位で返します。 _ismbblead への暗黙の呼び出しによって、c がマルチバイト文字の先行バイトを指していないと判断された場合、_mbclen の結果は予測できません。
mblen は、mbstr が有効なマルチバイト文字の場合はその長さをバイト単位で返し、コード ページに関連付けられているマルチバイト文字の有効性を決定します。 mblen は、mbstr に含まれる count 以下で、MB_CUR_MAX を超えない数のバイトを調べます。
出力値は、ロケールの LC_CTYPE カテゴリの設定で決まります。詳細については、「setlocale」を参照してください。 _l サフィックスが付いていないこの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。 詳細については、「ロケール」を参照してください。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_tclen |
マクロまたはインライン関数にマップされます |
_mbclen |
マクロまたはインライン関数にマップされます |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_mbclen |
<mbstring.h> |
mblen |
<stdlib.h> |
_mblen_l |
<stdlib.h> |
互換性の詳細については、「互換性」を参照してください。
使用例
// 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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。