_mbsnbset_s、_mbsnbset_s_l

项目
06/09/2015

设置多字节字符字符串的第一个 n 字节到指定的字符。 _mbsnbset、_mbsnbset_l 的这些版本如 CRT 中的安全功能所述，其安全得到了增强。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。有关更多信息，请参见不支持 /ZW 的 CRT 函数。

errno_t _mbsnbset_s(
   unsigned char *str,
   size_t size,
   unsigned int c,
   size_t count 
);
errno_t _mbsnbset_s_l(
   unsigned char *str,
   size_t size,
   unsigned int c,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbset_s(
   unsigned char (&str)[size],
   unsigned int c,
   size_t count 
); // C++ only
template <size_t size>
errno_t _mbsnbset_s_l(
   unsigned char (&str)[size],
   unsigned int c,
   size_t count,
   _locale_t locale
); // C++ only

参数

str
要修改的字符串。
size
字符串缓冲区的大小。
c
单字节或多字节字符集。
count
要设置的字节数。
locale
要使用的区域设置。

返回值

如果成功，则为零；否则为错误代码。

备注

_mbsnbset_s 和 _mbsnbset_s_l 函数设置，至多，str 的第一个 count 字节到 c。如果 count 比 str的长度更长时，使用str 代替 count。如果 c 是多字节字符，而且不能完全设置为由 count指定的最后一个字节，最后一个字节填充空白字符。 _mbsnbset_s 和 _mbsnbset_s_l在 str的末尾不会放置一个终止 null 。

_mbsnbset_s 和 _mbsnbset_s_l 与 _mbsnset相似，除了它们设置 count 字节而不是 c中的count 字符。

如果 str 是 NULL 或 count 为零，函数产生无效的参数异常，如参数验证所述。如果允许执行继续，errno设置为EINVAL，并且函数返回NULL。此外，如果 c 不是有效的多字节字符，errno 设置为 EINVAL，并使用空格。

输出值受区域设置的 LC_CTYPE 类设置影响；有关更多信息，请参见 setlocale、_wsetlocale。函数的_mbsnbset_s 版本对于区域设置相关的行为使用当前区域设置；_mbsnbset_s_l 版本是相同的，只不过它们使用传入的区域设置参数。有关详细信息，请参阅区域设置。

在 C++ 中，使用这些函数是由重载模板简化；该重载可以自动推断缓冲区长度，而无需指定范围参数。有关更多信息，请参见安全模板重载。

这些函数的调试版本首先用 0xFD 填充缓冲区。若要禁用此行为，请使用 _CrtSetDebugFillThreshold。

一般文本例程映射

Tchar.h 例程	未定义 _UNICODE 和 _MBCS	已定义 _MBCS	已定义 _UNICODE
_tcsnset_s	_strnset_s	_mbsnbset_s	_wcsnset_s
_tcsnset_s_l	_strnset_s _l	_mbsnbset_s_l	_wcsnset_s_l

要求

例程	必需的标头
_mbsnbset_s	<mbstring.h>
_mbsnbset_s_l	<mbstring.h>

有关更多兼容性信息，请参见兼容性。

示例

// crt_mbsnbset_s.c
#include <mbstring.h>
#include <stdio.h>

int main( void )
{
   char string[15] = "This is a test";
   /* Set not more than 4 bytes of string to be *'s */
   printf( "Before: %s\n", string );
   _mbsnbset_s( string, sizeof(string), '*', 4 );
   printf( "After:  %s\n", string );
}