_mbsnbcat、_mbsnbcat_l

项目
06/09/2015

至多，追加一个多字节字符字符串的第一个 n 字节到另一个字符串。有关这些函数的更多安全版本，请参见 _mbsnbcat_s、_mbsnbcat_s_l。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。有关详细信息，请参见 CRT functions not supported with /ZW（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 字符。如果在 count 字节追加之前， null 字节出现在 src中，_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++ 中，这些函数具有模板重载，以调用这些函数的更新、更安全副本。有关详细信息，请参阅安全模板重载。

一般文本例程映射