文字を小文字に変換します。
構文
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 サフィックスが付いているこれらの関数の各バージョンは、現在設定されているロケールの代わりに、パラメーターとして渡されたロケールを使用します。 詳細については、「 Locale」を参照してください。
_tolowerが期待される結果を得るには、__isasciiとisupperの両方が 0 以外の値を返す必要があります。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
汎用テキスト ルーチンのマップ
| TCHAR.H のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
|---|---|---|---|
_totlower |
tolower |
_mbctolower |
towlower |
_totlower_l |
_tolower_l |
_mbctolower_l |
_towlower_l |
Note
_tolower_l および _towlower_l はロケールに依存せず、直接呼び出すためのものではありません。 これらは、_totlower_l による内部使用のために用意されています。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
tolower |
<ctype.h> |
_tolower |
<ctype.h> |
towlower |
<ctype.h> または <wchar.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
「to 系関数」の例を参照してください。