_mbctolower、_mbctolower_l、_mbctoupper、_mbctoupper_l

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

マルチバイト文字が大文字か小文字かを調べて、大文字を小文字に、または小文字を大文字に変換します。

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 を調べて、可能な場合は次のいずれかの変換を行います。

ルーチン	変換
_mbctolower,_mbctolower_l	大文字を小文字に変換。
_mbctoupper,_mbctoupper_l	小文字を大文字に変換。

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

以前のバージョンでは、_mbctolower は jtolower と呼ばれ、_mbctoupper は 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