_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範例。