_mbsbtype、_mbsbtype_l
文字列内のバイトの種類を返します。
重要
この API は、Windows ランタイムで実行するアプリケーションでは使用できません。詳細については、「/ZW でサポートされない CRT 関数」を参照してください。
int _mbsbtype(
const unsigned char *mbstr,
size_t count
);
int _mbsbtype_l(
const unsigned char *mbstr,
size_t count,
_locale_t locale
);
パラメーター
mbstr
マルチバイト文字のシーケンスのアドレス。count
文字列の先頭からのバイト オフセット。locale
使用するロケール。
戻り値
_mbsbtype と _mbsbtype_lを示す整数値を指定されたバイトのテストの結果を返します。 次の表のマニフェスト定数は、Mbctype.h で定義されています。
戻り値 |
バイトの種類 |
|---|---|
_MBC_SINGLE (0) |
1 バイト文字。 たとえば、コード ページ 932 では、0x20 ～ 0x7E または 0xA1 ～ 0xDF の範囲のバイトを指定すると、_mbsbtype は 0 を返します。 |
_MBC_LEAD (1) |
マルチバイト文字の先行バイト。 たとえば、コード ページ 932 では、0x81 ～ 0x9F または 0xE0 ～ 0xFC の範囲のバイトを指定すると、_mbsbtype は 1 を返します。 |
_MBC_TRAIL (2) |
マルチバイト文字の後続バイト。 たとえば、コード ページ 932 では、0x40 ～ 0x7E または 0x80 ～ 0xFC の範囲のバイトを指定すると、_mbsbtype は 2 を返します。 |
_MBC_ILLEGAL (–1) |
mbstr のオフセット count の位置にあるバイトの前に見つかった、NULL 文字列、無効な文字、または NULL バイト。 |
解説
_mbsbtype 関数は、マルチバイト文字列のバイトの種類を判断します。 この関数は、mbstr のオフセット count の位置にあるバイトだけを調べます。指定されたバイトの前にある無効な文字は無視します。
出力値は、ロケールの LC_CTYPE カテゴリの設定で決まります。詳細については、「setlocale」を参照してください。 _l サフィックスが付いていないこの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。 詳細については、「ロケール」を参照してください。
入力文字列が NULL の場合、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、errno が EINVAL に設定され、関数から _MBC_ILLEGAL が返されます。
必要条件
ルーチン |
必須ヘッダー |
オプション ヘッダー |
|---|---|---|
_mbsbtype |
<mbstring.h> |
<mbctype.h>* |
_mbsbtype_l |
<mbstring.h> |
<mbctype.h>* |
* 戻り値として使用されるマニフェスト定数の場合。
互換性の詳細については、「互換性」を参照してください。
同等の .NET Framework 関数
該当するものはありません。ただし、「System::Globalization::CultureInfo」を参照してください。