通过

%>

  • 项目

将一个多字节字符串的前 n 个字节设置为指定字符。 这些版本的 _mbsnbset、_mbsnbset_l 具有安全增强功能，如 CRT 中的安全功能中所述。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。 有关详细信息，请参阅通用 Windows 平台应用中不支持的 CRT 函数。

语法

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 函数最多将 str 的前 count 个字节设置为 c。 如果 count 大于 str 的长度，则会使用 str 的长度而使用 count。 如果 c 是多字节字符，且不能完全设置到由 count 指定的最后一个字节中，则用空白字符填充最后一个字节。 _mbsnbset_s 和 _mbsnbset_s_l 未在 str 的末尾放置终止 null。

_mbsnbset_s 和 _mbsnbset_s_l 类似于 _mbsnset，只不过它们设置 c 的 count 个字节而不是 count 个字符。

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

输出值受区域设置的 LC_CTYPE 类别设置的影响。 有关详细信息，请参阅 setlocale。 此函数的 _mbsnbset_s 版本对与区域设置相关的行为使用当前区域设置，_mbsnbset_s_l 版本基本相同，但它改用传入的区域设置参数。 有关详细信息，请参阅 Locale。

在 C++ 中，这些函数的使用由模板重载简化；重载可以自动推导出缓冲区长度，从而不再需要指定大小自变量。 有关详细信息，请参阅安全模板重载。

这些函数的调试库版本首先用 0xFE 填充缓冲区。 若要禁用此行为，请使用 _CrtSetDebugFillThreshold。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

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 );
}

输出

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

另请参阅

字符串操作
%>