將字元轉換為大寫。
語法
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
函式中的範例。