_mbctolower、_mbctolower_l、_mbctoupper、_mbctoupper_l
マルチバイト文字が大文字か小文字かをテストして変換します。
重要
この API は、Windows ランタイムで実行するアプリケーションでは使用できません。詳細については、「/ZW でサポートされない CRT 関数」を参照してください。
unsigned int _mbctolower(
unsigned int c
);
unsigned int _mbctolower_l(
unsigned int c,
_locale_t locale
);
unsigned int _mbctoupper(
unsigned int c
);
unsigned int _mbctoupper_l(
unsigned int c,
_locale_t locale
);
パラメーター
c
変換するマルチバイト文字。locale
使用するロケール。
戻り値
これらの各関数は、可能であれば、変換される文字 c を返します。 それ以外の場合は、文字 c をそのまま返します。
解説
関数は、文字 c をテストし、可能であれば、次の変換のいずれか 1 つを適用します。
ルーチン |
変換 |
|---|---|
_mbctolower,_mbctolower_l |
大文字を小文字に変換します。 |
_mbctoupper,_mbctoupper_l |
小文字を大文字に変換します。 |
出力値は、ロケールの LC_CTYPE カテゴリの設定で決まります。詳細については、「setlocale」を参照してください。 _l サフィックスが付いていないこの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。 詳細については、「ロケール」を参照してください。
以前のバージョンでは、_mbctolower は jtolower と呼ばれ、 は jtoupper と呼ばれていました。 新しいコードでは、代わりに新しい名前を使用します。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_totlower |
tolower |
_mbctolower |
towlower |
_totlower_l |
_tolower_l |
_mbctolower_l |
_towlower_t |
_totupper |
toupper |
_mbctoupper |
towupper |
_totupper_l |
toupper_l |
_mbctoupper_l |
_towupper_l |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_mbctolower,_mbctolower_l |
<mbstring.h> |
_mbctoupper,_mbctoupper_l |
<mbstring.h> |
互換性の詳細については、「互換性」を参照してください。
参照
関連項目
_mbcjistojms、_mbcjistojms_l、_mbcjmstojis、_mbcjmstojis_l