_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 執行階段執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 CRT 函式。

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>

如需其他相容性資訊，請參閱相容性。

範例

請參閱 strlwr 的範例。

.NET Framework 對等用法

System::String::ToUpper

請參閱

參考

地區設定

字串操作 (CRT)

_strlwr、_wcslwr、_mbslwr、_strlwr_l、_wcslwr_l、_mbslwr_l