_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 不能在运行时的窗口执行的应用程序。有关更多信息，请参见 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>

有关其他的兼容性信息，请参见中介绍的 兼容性。

示例

为 _strlwr参见示例。

.NET Framework 等效项

System::String::ToUpper

请参见

参考

区域设置

字符串操作(crt)

_strlwr， _wcslwr， _mbslwr， _strlwr_l， _wcslwr_l， _mbslwr_l