strcat_s, wcscat_s, _mbscat_s

追加字符串。 这些是 strcat, wcscat, _mbscat 的版本与安全增强如 CRT中的安全功能所述。

重要

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

errno_t strcat_s(
   char *strDestination,
   size_t numberOfElements,
   const char *strSource 
);
errno_t wcscat_s(
   wchar_t *strDestination,
   size_t numberOfElements,
   const wchar_t *strSource 
);
errno_t _mbscat_s(
   unsigned char *strDestination,
   size_t numberOfElements,
   const unsigned char *strSource 
);
template <size_t size>
errno_t strcat_s(
   char (&strDestination)[size],
   const char *strSource 
); // C++ only
template <size_t size>
errno_t wcscat_s(
   wchar_t (&strDestination)[size],
   const wchar_t *strSource 
); // C++ only
template <size_t size>
errno_t _mbscat_s(
   unsigned char (&strDestination)[size],
   const unsigned char *strSource 
); // C++ only

参数

  • strDestination
    null 终止的目标字符串缓冲区。

  • numberOfElements
    目标字符串缓冲区的大小。

  • strSource
    null 终止的源字符串缓冲区。

返回值

零,如果成功;在失败的错误代码。

错误状态

strDestination

numberOfElements

strSource

返回值

strDestination内容

NULL 或未终止

any

any

EINVAL

不修改

any

any

NULL

EINVAL

strDestination[0] 设置为 0

any

0 或太小

any

ERANGE

strDestination[0] 设置为 0

备注

strcat_s 功能追加 strSource 到 strDestination 和停止使用 null 字符的结果字符串。 strSource 的初始字符复盖 strDestination终止 null 字符。 如果源页和目标字符串重叠,strcat_s 行为不确定。

注意第二个参数是缓冲区的总大小,而不是剩余的大小:

char buf[16];
strcpy_s(buf, 16, "Start");
strcat_s(buf, 16, " End");               // Correct
strcat_s(buf, 16 – strlen(buf), " End"); // Incorrect

wcscat_s 和 _mbscat_s 是 strcat_s的宽字符和多字节字符版本。 参数和返回 wcscat_s 的值是宽字符字符串;这些 _mbscat_s 的多字节字符字符串。 这三个功能否则具有相同的行为。

如果 strDestination 是 null 指针或不 null 终止,或者,如果 strSource 是 NULL 指针,或者,如果目标字符串过小;无效参数调用处理程序,如 参数验证所述。 如果执行允许继续,这些函数返回 EINVAL 并将 errno 到 EINVAL。

在 C++ 中,使用这些功能由模板超加载简化;超加载可能推断缓冲区长度 (自动不再需要指定范围参数),并且还可以用以较新,安全重复自动替换旧,不安全的功能。 有关更多信息,请参见安全模板重载

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

一般文本例程映射

TCHAR.H 实例

未定义的_UNICODE & _MBCS

定义的_MBCS

定义的_UNICODE

_tcscat_s

strcat_s

_mbscat_s

wcscat_s

要求

实例

必需的标头

strcat_s

<string.h>

wcscat_s

<string.h> 或 <wchar.h>

_mbscat_s

<mbstring.h>

有关其他的兼容性信息,请参见中介绍的 兼容性

示例

在参见 strcpy_s, wcscpy_s, _mbscpy_s的代码示例。

.NET Framework 等效项

System::String::Concat

请参见

参考

字符串操作(crt)

strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l

_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

strspn, wcsspn, _mbsspn, _mbsspn_l