%>

最多将一个多字节字符字符串的前 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 结尾的字符串不得超过目标缓冲区的大小。 有关详细信息,请参阅避免缓冲区溢出

如果 destsrcNULL,则这些函数将生成无效的参数错误,如参数验证中所述。 如果处理了错误,则该函数返回 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>

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

另请参阅

字符串操作
%>

%>
%>
%>

%>