_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 で定義されます。

戻り値	Byte 型
_MBC_SINGLE (0)	バイト文字。たとえば、コード ページ 932 では、_mbsbtype 指定されたバイトがスコープ– 0x7E 0x20 か 0xA1 – 0xDF 内にある場合は 0 を返します。
_MBC_LEAD (1)	マルチバイト文字の先行バイト。たとえば、コード ページ 932 では、_mbsbtype 指定されたバイトがスコープ 0x81 – 0x9F か 0xE0 – 0xFC 内にある場合は 1 を返します。
_MBC_TRAIL (2)	マルチバイト文字の後続バイト数。たとえば、コード ページ 932 では、_mbsbtype 指定されたバイトがスコープ– 0x7E 0x40 や 0x80 – 0xFC 内にある場合は 2 を返します。
_MBC_ILLEGAL (–1)	NULL の文字列、無効な文字、または NULL のバイトは mbstrオフセットの count でバイトの前に見つかりました。

解説

_mbsbtype 関数はマルチバイト文字列のバイト型を決定します。関数は、指定されたバイトの前に無効な文字を無視 mbstrオフセットの count バイトでのみが調べられます。

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

入力文字列が NULL場合、無効なパラメーター ハンドラーが パラメーターの検証に説明されているように、開始されます。実行の継続が許可された場合、errno が EINVAL に設定され、関数から _MBC_ILLEGAL が返されます。

必要条件

ルーチン	必須ヘッダー	オプション ヘッダー
_mbsbtype	<mbstring.h>	<mbctype.h>*
_mbsbtype_l	<mbstring.h>	<mbctype.h>*

*戻り値として使用するマニフェスト定数の場合は。

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

同等の .NET Framework 関数

適用できませんが、System::Globalization::CultureInfoが表示されます。

参照

関連項目

バイト分類