tolower, _tolower, towlower, _tolower_l, _towlower_l

  • [アーティクル]

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

構文

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 、 __isasciiisupper 両方とも 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参照してください。

関連項目

データ変換
is、 isw ルーチン
to 関数
ロケール
マルチバイト文字シーケンスの解釈