共用方式為


_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