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 為非零的寬字元，且 iswupper 為非零，則 towupper 會傳回對應的寬字元的對應的寬字元;否則， towupper 會傳回未變更的 c 。

未保留表示錯誤的傳回值。

針對 toupper 中的預期結果， __isascii 和 islower 都必須為傳回非零。

備註

這些常式若可能都會轉換成特定小寫字母的大寫字母和大小。 towupper 案例轉換是地區設定特性的。 使用目前的地區設定相關只變更字元。 沒有 _l 尾碼的函式使用目前設定的地區設定。 這些函式版本與 _l 結尾的會將地區設定做為參數並使用該控制項而不是目前設定的地區設定。 如需詳細資訊，請參閱地區設定。

針對 toupper 中的預期結果， __isascii 和 isupper 都必須為傳回非零。

資料轉換常式

一般文字常式對應

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>

如需其他相容性資訊，請參閱＜簡介＞中的相容性。

範例

請參閱 對函式中的範例。

.NET Framework 對等用法

System::Char::ToUpper

請參閱

參考

is、isw 常式

to 函式

地區設定

多位元組字元序列的解譯