_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。有关更多信息,请参见平台调用示例

请参见

参考

字符串操作(crt)

_mbsnbcat, _mbsnbcat_l

_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l

_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l