_mbsnbcat，_mbsnbcat_l

最多将一个多字节字符字符串的前 n 个字节追加到另一个字符串。 提供这些函数的更安全版本；请参阅 _mbsnbcat_s、_mbsnbcat_s_l。

重要

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

语法

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 函数最多可以将 src 的第一个 count 字节追加到 dest。 如果 dest 中紧靠空字符之前的字节是前导字节，则 src 的初始字节将覆盖此前导字节。 否则，src 的初始字节会覆盖 dest 的终止 null 字符。 如果在 src 字节追加之前，null 字节出现在 count 中，_mbsnbcat 将追加来自 src 的所有字节，直到 null 字符。 如果 count 大于 src 的长度，则会使用 src 的长度代替 count。 生成的字符串由空字符终止。 如果复制出现在重叠的字符串之间，则该行为不确定。

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

安全说明 使用以 null 结尾的字符串。 以 null 结尾的字符串不得超过目标缓冲区的大小。 有关详细信息，请参阅避免缓冲区溢出。

如果 dest 或 src 为 NULL，则这些函数将生成无效的参数错误，如参数验证中所述。 如果处理了错误，则该函数返回 EINVAL 并将 errno 设置为 EINVAL。

在 C++ 中，这些函数具有模板重载，以调用这些函数的更新、更安全副本。 有关详细信息，请参阅安全模板重载。

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

一般文本例程映射

Tchar.h 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_tcsncat	strncat	_mbsnbcat	wcsncat
_tcsncat_l	_strncat_l	_mbsnbcat_l	_wcsncat_l

要求

例程	必需的标头
_mbsnbcat	<mbstring.h>
_mbsnbcat_l	<mbstring.h>

有关兼容性的详细信息，请参阅 兼容性。

另请参阅

字符串操作
_mbsnbcmp、_mbsnbcmp_l
_strncnt、_wcsncnt、_mbsnbcnt、_mbsnbcnt_l、_mbsnccnt、_mbsnccnt_l
_mbsnbcpy、_mbsnbcpy_l
_mbsnbicmp、_mbsnbicmp_l
_mbsnbset、_mbsnbset_l
strncat、_strncat_l、wcsncat、_wcsncat_l、_mbsncat、_mbsncat_l
_mbsnbcat_s、_mbsnbcat_s_l