_mbsnbset、_mbsnbset_l

设置多字节字符字符串的第一个 n 字节到指定的字符。 有关这些函数的更多安全版本，请参见 _mbsnbset_s、_mbsnbset_s_l。

unsigned char *_mbsnbset(
   unsigned char *str,
   unsigned int c,
   size_t count 
);
unsigned char *_mbsnbset_l(
   unsigned char *str,
   unsigned int c,
   size_t count,
   _locale_t locale
);

参数

• str
  要修改的字符串。

• c
  单字节或多字节字符集。

• count
  要设置的字节数。

• locale
  要使用的区域设置。

返回值

_mbsnbset返回指向修改后的字符串的指针。

备注

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

_mbsnbset 和 _mbsnbset_l类似于 _mbsnset，除此之外，设置 count 字节而不是 c的count 字符。

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

输出值受区域设置的 LC_CTYPE 类设置影响；有关更多信息，请参见 setlocale。 这些带有 _mbsnbset 后缀的函数的版本为区域设置相关相关行为使用当前区域设置；带有_mbsnbset_l 版本的相同，只不过它们使用区域设置参数通过。 有关详细信息，请参阅区域设置。

安全说明   此 API 会导致由缓冲区溢出问题引起的潜在威胁。 缓冲区溢出问题是常见的系统攻击方法，使权限的提升不能确保。 有关更多信息，请参见避免缓冲区溢出。

一般文本例程映射

要求

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

示例

// crt_mbsnbset.c
// compile with: /W3
#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( string, '*', 4 ); // C4996
   // Note; _mbsnbset is deprecated; consider _mbsnbset_s
   printf( "After:  %s\n", string );
}

Output

Before: This is a test
After:  **** is a test

.NET Framework 等效项

不适用。若要调用标准 C 函数，请使用 PInvoke。有关更多信息，请参见平台调用示例。

请参见

参考

字符串操作 (CRT)

_mbsnbcat、_mbsnbcat_l

_strnset、_strnset_l、_wcsnset、_wcsnset_l、_mbsnset、_mbsnset_l

_strset、_strset_l、_wcsset、_wcsset_l、_mbsset、_mbsset_l