_mbsnbset_s, _mbsnbset_s_l
设置多字节字符字符串的第一个 n 字节到指定的字符。 _mbsnbset, _mbsnbset_l 的这些版本具有安全增强功能,如 CRT中的安全功能所述。
重要
此 API 不能在 Windows 运行时执行的应用程序。有关更多信息,请参见 CRT 函数不支持与 /ZW。
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 函数设置,至多,第一个 count 字节 str 到 c。 如果 count 比 str的长度时,str 的长度使用而不是 count。 如果 c 的多字节字符,但不能完全设置为由 count指定的最后一个字节,最后一个字节填充空白字符。 _mbsnbset_s 和 _mbsnbset_s_l 不将终止 null 在 str的末尾。
_mbsnbset_s 和 _mbsnbset_s_l 类似于 _mbsnset,不同之处在于,它们设置 count 字节而不是 ccount 字符。
如果 str 是 NULL 或 count 为零,此功能生成无效的参数异常,如 参数验证所述。 如果执行允许继续,errno 设置为 EINVAL,函数返回 NULL。 此外,如果 c 不是有效的多字节字符,errno 设置为 EINVAL,并使用空格。
输出值受设置 LC_CTYPE 类设置的影响区域设置;请参见 setlocale, _wsetlocale 有关更多信息。 此函数的 _mbsnbset_s 版本为该区域设置相关的行为使用当前区域设置;_mbsnbset_s_l 版本相同,只不过它使用的区域设置参数。 有关更多信息,请参见区域设置。
在 C++ 中,这些功能的使用由模板超加载简化;超加载可能自动推断缓冲区长度从而无需指定范围参数。 有关更多信息,请参见安全模板重载。
这些函数的" debug "版本用 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 );
}
Output
.NET Framework 等效项
不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见平台调用示例。
请参见
参考
_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l