_mbsnbset， _mbsnbset_l
设置多字节字符字符串的第一个 n 字节到指定的字符。 这些功能的更安全版本可用；请参见 _mbsnbset_s， _mbsnbset_s_l。
重要
此 API 不能在运行时的窗口执行的应用程序。有关更多信息，请参见 CRT 函数不支持与 /ZW。
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 函数设置，至多，第一个 count 字节 str 到 c。 如果 count 比 str的长度时，str 的长度使用而不是 count。 如果 c 的多字节字符，但不能完全设置为 count指定的最后一个字节，最后一个字节填充空白字符。 _mbsnbset 和 _mbsnbset_l不将终止 null 在 str的末尾。
_mbsnbset 和 _mbsnbset_l类似于 _mbsnset，除此之外，设置 count 字节而不是 ccount 字符。
如果 str 是 NULL 或 count 为零，此功能生成无效的参数异常。参数验证所述。 如果执行允许继续，errno 设置为 EINVAL，函数返回 NULL。 此外，如果 c 不是有效的多字节字符，errno 设置为 EINVAL，并使用空格。
输出值受设置 LC_CTYPE 类设置的影响区域设置；请参见 setlocale 有关更多信息。 此函数的 _mbsnbset 版本为该区域设置相关的行为使用当前区域设置；_mbsnbset_l 版本与相同，但它区域设置参数传递的使用。 有关更多信息，请参见区域设置。
安全说明" 此 API 会导致缓冲区溢出问题实现的潜在的威胁。 缓冲区溢出问题是系统攻击一个常见的方案，使权限的非确保提升。 有关更多信息，请参见 避免缓冲区溢出。
一般文本例程映射
Tchar.h 实例 |
未定义的_UNICODE 和_MBCS |
定义的_MBCS |
定义的_UNICODE |
|---|---|---|---|
_tcsnset |
_strnset |
_mbsnbset |
_wcsnset |
_tcsnset_l |
_strnset_l |
_mbsnbset_l |
_wcsnset_l |
要求
实例 |
必需的标头 |
|---|---|
_mbsnbset |
<mbstring.h> |
_mbsnbset_l |
<mbstring.h> |
有关更多兼容性信息，请参见中介绍的 兼容性。
示例
// 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。有关更多信息，请参见 平台调用示例。
请参见
参考
_strnset， _strnset_l， _wcsnset， _wcsnset_l， _mbsnset， _mbsnset_l