次の方法で共有


_mbctolower_mbctolower_l_mbctoupper_mbctoupper_l

マルチバイト文字が大文字か小文字かをテストして変換します。

重要

この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない 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 サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。 詳細については、「 Locale」を参照してください。

以前のバージョンでは、 _mbctolowerjtolowerと呼ばれ、 _mbctoupperjtoupperと呼ばれます。 新しいコードでは、代わりに新しい名前を使用します。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

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

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>

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

データ変換
_mbbtombc, _mbbtombc_l
_mbcjistojms_mbcjistojms_l_mbcjmstojis_mbcjmstojis_l
_mbctohira_mbctohira_l_mbctokata_mbctokata_l
_mbctombb, _mbctombb_l