_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

將字串轉換成大寫。 這些函式有更安全的版本可供使用;請參閱 、、 _strupr_s_l 、 _mbsupr_s_l_mbsupr_s 、 _wcsupr_s 、 _wcsupr_s_l 。 _strupr_s

重要

在 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