_mbsnbcat_s， _mbsnbcat_s_l

项目
04/10/2013

追加多字节字符字符串，至多，第一个 n 字节另一个多字节字符字符串。这些是具有安全增强 _mbsnbcat， _mbsnbcat_l 的版本，如 CRT中的安全功能所述。

重要

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

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。如果紧邻在 dest null 字符的字节是前导字节，它由初始字节 src复盖。否则，初始字节 src 复盖 dest终止 null 字符。如果 null 字节出现在 src，在 count 字节追加之前，_mbsnbcat_s 追加从 src的所有字节，到在 null 字符。如果 count 比 src的长度时，src 的长度。count位置。结果字符串由 null 字符终止。如果复制出现在重叠的字符串之间，该行为不确定。

输出值受设置 LC_CTYPE 类设置的影响区域设置；请参见 setlocale， _wsetlocale 有关更多信息。这些功能的版本相同，不同之处在于，没有 _l 后缀使用当前区域设置和一个位置 _l 后缀使用区域设置参数传递的脚本。有关更多信息，请参见区域设置。

在 C++ 中，使用这些功能由模板超加载简化；超加载可能自动推断缓冲区长度从而无需指定范围参数，可自动将使用以较新，更安全的函数取代以前，少安全功能。有关更多信息，请参见安全模板重载。

这些函数的" debug "版本用 0xFD 首先加载缓冲区。若要禁用此行为，请使用 _CrtSetDebugFillThreshold。

一般文本例程映射