tolower、_tolower、towlower、_tolower_l、_towlower_l

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

更新 : 2007 年 11 月

文字を小文字に変換します。

int tolower(
   int c 
);
int _tolower(
   int c 
);
int towlower(
   wint_t c 
);
int _tolower_l(
   int c,
   _locale_t locale 
);
int _towlower_l(
   wint_t c,
   _locale_t locale 
);

パラメータ

[入力] c
変換する文字。
[入力] locale
ロケール固有の変換に使用するロケール。

戻り値

これらのルーチンは、可能な場合には c のコピーを小文字に変換し、その結果を返します。エラーの戻り値はありません。

解説

これらの各ルーチンは、可能であり適切な場合に、指定された大文字を適宜小文字に変換します。towlower の大文字/小文字の変換は、ロケール固有です。現在のロケールに関連する文字の大文字/小文字のみが変換されます。_l サフィックスが付いていない関数は、現在設定されているロケールを使用します。_l サフィックスが付いている関数のバージョンは、現在設定されているロケールの代わりにパラメータとして渡されたロケールを使用します。詳細については、「ロケール」を参照してください。

_tolower が予想どおりの結果を返すためには、__isascii と isupper がどちらも 0 以外を返す必要があります。

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

TCHAR.H のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_totlower	tolower	_mbctolower	towlower
_totlower_l	_tolower_l	_mbctolower_l	_towlower_l

メモ :
_tolower_l と _towlower_l は、ロケールに依存していません。また、直接呼び出されることはありません。これらの変数は _totlower_l で内部的に使用されます。