Share via

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。

沒有保留表示錯誤的傳回值。

備註

這些常式都會將指定的小寫字母轉換為大寫字母 (如果可能且適當的話)。 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 函數
地區設定
多位元組字元序列的解譯