_strupr_s、_strupr_s_l、_mbsupr_s、_mbsupr_s_l、_wcsupr_s、_wcsupr_s_l

项目
06/09/2015

将字符串转换为大写，使用当前区域设置或通过的指定区域设置。 _strupr、_strupr_l、_mbsupr、_mbsupr_l、_wcsupr_l、_wcsupr 的这些版本如 CRT 中的安全功能所述，其安全得到了增强。

重要

_mbsupr_s 和 _mbsupr_s_l 不能在 Windows 运行时执行的应用程序中使用。有关详细信息，请参见 CRT functions not supported with /ZW（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。