共用方式為


將字元轉換為大寫。

語法

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 函式中的範例。

另請參閱

is, isw 常式
to 函數
地區設定
多位元組字元序列的解譯