_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l
将字符串转换为大写,使用传入的当前区域设置或指定的区域设置。 这些是 _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr 的版本与安全增强如 CRT中的安全功能所述。
重要
_mbsupr_s 和 _mbsupr_s_l 不能在运行时的窗口执行的应用程序。有关更多信息,请参见 CRT 函数不支持与 /ZW。
errno_t _strupr_s(
char *str,
size_t numberOfElements
);
errno_t _wcsupr_s(
wchar_t * str,
size_t numberOfElements
);
errno_t _strupr_s_l(
char * str,
size_t numberOfElements,
_locale_t locale
);
errno_t _wcsupr_s_l(
wchar_t * str,
size_t numberOfElements,
_locale_t locale
);
errno_t _mbsupr_s(
unsigned char *str,
size_t numberOfElements
);
errno_t _mbsupr_s_l(
unsigned char *str,
size_t numberOfElements,
_locale_t locale
);
template <size_t size>
errno_t _strupr_s(
char (&str)[size]
); // C++ only
template <size_t size>
errno_t _wcsupr_s(
wchar_t (&str)[size]
); // C++ only
template <size_t size>
errno_t _strupr_s_l(
char (&str)[size],
_locale_t locale
); // C++ only
template <size_t size>
errno_t _wcsupr_s_l(
wchar_t (&str)[size],
_locale_t locale
); // C++ only
template <size_t size>
errno_t _mbsupr_s(
unsigned char (&str)[size]
); // C++ only
template <size_t size>
errno_t _mbsupr_s_l(
unsigned char (&str)[size],
_locale_t locale
); // C++ only
参数
str
大写的字符串。numberOfElements
缓冲区的大小。locale
使用的区域设置。
返回值
零,如果成功;在失败的一个非零错误代码。
这些功能验证其参数。 如果 str 是 NULL 指针,无效参数调用处理程序,如 参数验证 所述。 如果执行允许继续,函数返回 EINVAL 并将 errno 到 EINVAL。 如果 numberOfElements 与该字符串的长度,函数返回 ERANGE 并将 errno 到 ERANGE。
备注
_strupr_s 函数,例如,在 str 的每个小写字母转换为大写。 _wcsupr_s 是 _strupr_s的宽字符版本。 _mbsupr_s 是 _strupr_s的多字节字符版本。
转换取决于 LC_CTYPE 类别设置区域设置。 其他字符不受影响。 有关 LC_CTYPE的更多信息,请参见 setlocale。 这些功能的版本不 _l 后缀使用当前的区域设置;与 _l 后缀的可视相同,只不过它们使用的区域设置。 有关更多信息,请参见区域设置。
在 C++ 中,使用这些功能由模板超加载简化;超加载可能推断缓冲区长度 (自动不再需要指定范围参数),并且还可以用以较新,安全重复自动替换旧,不安全的功能。 有关更多信息,请参见安全模板重载。
这些函数的" debug "版本用 0xFD 首先加载缓冲区。 若要禁用此行为,请使用 _CrtSetDebugFillThreshold。
一般文本例程映射
TCHAR.H 实例 |
未定义的_UNICODE & _MBCS |
定义的_MBCS |
定义的_UNICODE |
---|---|---|---|
_tcsupr_s |
_strupr_s |
_mbsupr_s |
_wcsupr_s |
_tcsupr_s_l |
_strupr_s_l |
_mbsupr_s_l |
_wcsupr_s_l |
要求
实例 |
必需的标头 |
---|---|
_strupr_s, _strupr_s_l |
<string.h> |
_wcsupr_s, _wcsupr_s_l, _mbsupr_s, _mbsupr_s_l |
<string.h> 或 <wchar.h> |
有关其他的兼容性信息,请参见中介绍的 兼容性。
示例
为 _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l 参见示例。
.NET Framework 等效项
请参见
参考
_strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l