_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