_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 等效项

System::String::ToUpper

请参见

参考

区域设置

多字节字符序列的说明

字符串操作(crt)

_strlwr_s， _strlwr_s_l， _mbslwr_s， _mbslwr_s_l， _wcslwr_s， _wcslwr_s_l