_mbsnbcat， _mbsnbcat_l

项目
04/10/2013

追加，至多，第一个 n 字节一个多字节字符字符串与另一个。这些功能的更安全版本可用；请参见 _mbsnbcat_s， _mbsnbcat_s_l。

重要

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

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

参数

dest
null 终止的多字节字符目标字符串。
src
null 终止的多字节字符源字符串。
count
字节数从追加的 src 于 dest。
locale
使用的区域设置。

返回值

_mbsnbcat 返回指向目标字符串。没有任何返回值保留指示错误。

备注

_mbsnbcat 功能追加，至多，第一个 count 字节 src 到 dest。如果在 null 字符之前的字节在 dest 是前导字节，初始字节 src 复盖此前导字节。否则，初始字节 src 复盖 dest终止 null 字符。如果 null 字节出现在 src，在 count 字节追加之前，_mbsnbcat 追加从 src的所有字节，到在 null 字符。如果 count 比 src的长度时，src 的长度。count位置。结果字符串停止点与 null 字符。如果复制出现在重叠的字符串之间，该行为不确定。

输出值受设置 LC_CTYPE 类设置的影响区域设置；请参见 setlocale 有关更多信息。函数的 _mbsnbcat 版本为该区域设置相关的行为使用当前区域设置；_mbsnbcat_l 版本相同，只不过它们使用传入的区域设置参数。有关更多信息，请参见区域设置。

Security Note 使用以 NULL 结尾的字符串。该 null 终止的字符串不能超过目标缓冲区的大小。有关更多信息，请参见避免缓冲区溢出。

如果 dest 或 src 是 NULL，函数将生成一个无效参数错误，如参数验证所述。如果错误进行处理，函数返回 EINVAL 并将 errno 到 EINVAL。

在 C++ 中，这些函数的调用的模板超负载越 + 新，保证这些函数副本。有关更多信息，请参见安全模板重载。

一般文本例程映射