_mbsnbset、_mbsnbset_l
设置多字节字符字符串的第一个 n 字节到指定的字符。 有关这些函数的更多安全版本，请参见 _mbsnbset_s、_mbsnbset_s_l。
重要
此 API 不能用于在 Windows 运行时中执行的应用程序。有关详细信息，请参见 CRT functions not supported with /ZW（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 函数设置，至多，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 会导致由缓冲区溢出问题引起的潜在威胁。 缓冲区溢出问题是常见的系统攻击方法，使权限的提升不能确保。 有关更多信息，请参见避免缓冲区溢出。
一般文本例程映射
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。有关更多信息，请参见平台调用示例。