將字元轉換為大寫。
語法
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 為非零值，而且有對應的寬字元，其 iswupper 是非零值，則 towupper 會傳回對應的寬字元，否則會維持 towupper 傳回 c。
沒有保留表示錯誤的傳回值。
備註
這些常式都會將指定的小寫字母轉換為大寫字母 (如果可能且適當的話)。 towupper 的大小寫轉換是地區設定特性。 只有與目前地區設定相關字元的大小寫會變更。 沒有 _l 後置字元的函式會使用目前設定的地區設定。 具有 _l 字尾的函式版本採用地區設定作為參數，並使用該地區設定，而不是目前設定的地區設定。 如需詳細資訊，請參閱 Locale。
若要 toupper 提供預期的結果，__isascii 必須傳回非零值。
根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。
一般文字常式對應
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> |
如需相容性詳細資訊，請參閱相容性。
範例
請參閱 to 函式中的範例。