_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参见示例。