toupper、_toupper、towupper、_toupper_l、_towupper_l
文字を大文字に変換します。
int toupper(
int c
);
int _toupper(
int c
);
int towupper(
wint_t c
);
int _toupper_l(
int c ,
_locale_t locale
);
int _towupper_l(
wint_t c ,
_locale_t locale
);
パラメーター
c
変換する文字。locale
使用するロケール。
戻り値
これらのルーチンでは、cのコピーを、変換し、その結果を返します。
c はワイド文字 iswlower である 0 以外のであり、iswupper が 0 以外のの対応するワイド文字があり、towupper が対応するワイド文字列を返す; それ以外の場合は、そのまま towupper の戻り c。
エラーを示すために予約された戻り値はありません。
toupper を想定した結果、__isascii と islower を与えることも 0 以外のな値です。
解説
これらのルーチン可能な場合には、それぞれ特定の大文字と小文字を変換し、割り当てます。 towupper の大文字と小文字の変換はロケール固有です。 現在のロケールに対応する文字のみが変更されます。 _lサフィックスのない関数は、現在設定されているロケールを使用します。 _lのサフィックスが付いているこれらの関数の各バージョンはロケールをパラメーターとして受け取り、現在設定されているロケールの代わりに使用します。 詳細については、「ロケール」を参照してください。
toupper を想定した結果、__isascii と isupper を与えることも 0 以外のな値です。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE & _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_totupper |
toupper |
_mbctoupper |
towupper |
_totupper_l |
_toupper_l |
_mbctoupper_l |
_towupper_l |
注意
_toupper_l および _towupper_l はロケールに依存せず、直接呼び出すためのものではありません。これらは、_totupper_l による内部使用のために用意されています。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
toupper |
<ctype.h> |
_toupper |
<ctype.h> |
towupper |
<ctype.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
関数にの例を参照してください。