_mbsnbcat_s、_mbsnbcat_s_l

项目
06/09/2015

追加到多字节字符字符串，至多，第一个 n 字节另一个多字节字符字符串。 _mbsnbcat、_mbsnbcat_l 的一些版本提供安全增强功能（如 CRT 中的安全功能所述）。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。有关更多信息，请参见不支持 /ZW 的 CRT 函数。

errno_t _mbsnbcat_s(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count 
);
errno_t _mbsnbcat_s_l(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbcat_s(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count 
); // C++ only
template <size_t size>
errno_t _mbsnbcat_s_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

参数

dest
以null 终止的多字节字符的目标字符串。
sizeInBytes
dest缓冲区的大小（以字节为单位）。
src
以null 终止的多字节字符的源字符串。
Count
字节数从src 追加到 dest。
locale
要使用的区域设置。

返回值

如果成功，则为零；否则为错误代码。

错误情况

Dest	sizeInBytes	src	返回值
NULL	any	any	EINVAL
任意	<= 0	any	EINVAL
任意	any	NULL	EINVAL

如果任何一个错误状态，当函数生成无效的参数错误，如参数验证所述。如果错误被处理，函数将返回 EINVAL ，并将errno设置为EINVAL 。

备注

_mbsnbcat_s 函数至追加 dest 第一个字节 count 到 src。如果在null 字符之前的字节在 dest 是前导字节，则src 的初始字节复盖此前导字节。否则，src的初始字节复盖 dest的终止 null 字符。如果在count 字节追加之前， null 字节出现在 src中，__mbsnbcat_s 追加来自 src的所有字节，直到 null 字符。如果 count 比 src的长度更长时，使用src的长度代替 count。该字符串以 null字符终止。如果复制出现在重叠的字符串之间，则该行为不确定。

输出值受区域设置的 LC_CTYPE 类设置影响；有关更多信息，请参见 setlocale、_wsetlocale。除了不具有使用当前区域的 _l 后缀以及具有 _l 后缀而不是使用传入的区域参数，这些函数的版本相同。有关详细信息，请参阅区域设置。

在 C++ 中，使用这些函数由模板重载简化；重载可以自动推导出缓冲区长度 (不再需要指定大小参数)，并且它们可以自动用以更新、更安全的对应物替换旧的、不安全的函数。有关更多信息，请参见安全模板重载。

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

一般文本例程映射