_strupr
、、_strupr_l
_mbsupr
、_mbsupr_l
、、_wcsupr_l
、_wcsupr
將字串轉換成大寫。 這些函式已有更安全的版本可用,請參閱 _strupr_s
、_strupr_s_l
、_mbsupr_s
、_mbsupr_s_l
、_wcsupr_s
、_wcsupr_s_l
、。
重要
在 Windows 執行階段中執行的應用程式中無法使用 _mbsupr
和 _mbsupr_l
。 如需詳細資訊,請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 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
後置字元的版本與其相同,只不過它們會改用傳入的地區設定。 如需詳細資訊,請參閱 Locale。
_wcsupr
和 _mbsupr
分別是 _strupr
的寬字元版本和多位元組字元版本。 的自變數和傳回值 _wcsupr
是寬字元字串。 的自變數和傳回值 _mbsupr
是多位元組位元元字串。 除此之外,這三個函式的行為相同。
如果 str
為 null 指標,則會叫用無效的參數處理常式,如參數驗證中所述。 如果允許繼續執行,這些函式會傳回原始字串並將 errno
設為 EINVAL
。
在 C++ 中,這些函式具有樣板多載,可以叫用這些函式的更新且安全的對應版本。 如需詳細資訊,請參閱安全範本多載。
根據預設,此函式的全域狀態會限定於應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
一般文字常式對應
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
的範例。
另請參閱
地區設定
字串操作
_strlwr
、、_wcslwr
_mbslwr
、_strlwr_l
、、_wcslwr_l
、_mbslwr_l