_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」を参照してください。

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

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「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