_strupr、 _strupr_l、 _mbsupr、 _mbsupr_l、 _wcsupr_l、 _wcsupr

將字串轉換成大寫。更多這些函式的可用安全版本，請參閱 _strupr_s、 _strupr_s_l、 _mbsupr_s、 _mbsupr_s_l、 _wcsupr_s、 _wcsupr_s_l 。

重要事項
_mbsupr 和 _mbsupr_l 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

char *_strupr(
   char *str 
);
wchar_t *_wcsupr(
   wchar_t *str 
);
unsigned char *_mbsupr(
   unsigned char *str 
);
char *_strupr_l(
   char *str,
   _locale_t locale
);
wchar_t *_wcsupr_l(
   wchar_t *str,
   _locale_t locale
);
unsigned char *_mbsupr_l(
   unsigned char *str,
   _locale_t locale
);
template <size_t size>
char *_strupr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcsupr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbsupr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strupr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcsupr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbsupr_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

參數

• str
  大寫的字串。

• locale
  使用的地區設定。

傳回值

讓指標回到修改的字串。由於修改已完成，則傳回的指標是當成指標傳遞做為輸入引數的相同。傳回值不會保留表示錯誤。

備註

_strupr 函式轉換，準備就緒， str 中的每個小寫字母轉換為大寫。轉換取決於地區設定分類的 LC_CTYPE 設定。其他字元不會受到影響。如需 LC_CTYPE，請參閱 setlocale。這些函式版本沒有 _l 尾碼來使用目前的地區設定;與 _l 結尾的版本相同，但使用的地區設定。如需詳細資訊，請參閱地區設定。

_wcsupr 和 _mbsupr 是 _strupr 的寬字元和多位元組字元版本。引數和傳回值 _wcsupr 是寬字元字串;這些 _mbsupr 是多位元組字元字串。這三個函式其餘部分的運作相同。

如果 str 為 null 指標，無效的參數叫用處理常式，如 參數驗證 中所述。如果執行允許繼續執行，這些函式會傳回原始字串並將 errno 設為 EINVAL。

在 C++ 中，這些函式有多載樣板可以調用更新、更安全的這些函式的相對版本。如需詳細資訊，請參閱安全範本多載。

泛用文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_tcsupr	_strupr	_mbsupr	_wcsupr
_tcsupr_l	_strupr_l	_mbsupr_l	_wcsupr_l

需求

程序	必要的標頭檔
_strupr, _strupr_l	<string.h>
_wcsupr, _wcsupr_l	<string.h> 或 <wchar.h>
_mbsupr, _mbsupr_l	<mbstring.h>

如需其他相容性資訊，請參閱入門介紹中的 相容性 (Compatibility) 。

範例

請參閱 _strlwr範例。

.NET Framework 對等用法

System::String::ToUpper

請參閱

參考

地區設定

字串操作 (CRT)

_strlwr、 _wcslwr、 _mbslwr、 _strlwr_l、 _wcslwr_l、 _mbslwr_l