strcat、wcscat、_mbscat
追加一个字符串。 有关这些函数的更多安全版本,请参见 strcat_s、wcscat_s、_mbscat_s。
重要
_mbscat_s 不能用于在 Windows 运行时中执行的应用程序。有关详细信息,请参见 CRT functions not supported with /ZW(CRT 函数不支持使用/ZW)。
char *strcat(
char *strDestination,
const char *strSource
);
wchar_t *wcscat(
wchar_t *strDestination,
const wchar_t *strSource
);
unsigned char *_mbscat(
unsigned char *strDestination,
const unsigned char *strSource
);
template <size_t size>
char *strcat(
char (&strDestination)[size],
const char *strSource
); // C++ only
template <size_t size>
wchar_t *wcscat(
wchar_t (&strDestination)[size],
const wchar_t *strSource
); // C++ only
template <size_t size>
unsigned char *_mbscat(
unsigned char (&strDestination)[size],
const unsigned char *strSource
); // C++ only
参数
strDestination
以NULL中止的目的字符串。strSource
null 终止的源字符串。
返回值
这些函数都返回一个目标字符串 (strDestination)。 没有保留任何返回值以指示错误。
备注
strcat 功能追加 strSource 到 strDestination 并停止使用 null 字符的结果字符串。 strSource 的初始字符覆盖 strDestination终止 null 字符。 如果源和目标字符串重叠,则 strcat 的行为未定义。
安全说明 |
---|
由于 strcat 在追加 strSource 之前不会检查是否在 strDestination 有足够空间,这是一个可能导致缓冲区溢出的原因。 考虑改用 strncat 代替。 |
wcscat 和 _mbscat 是宽字符,属于 strcat的多节字字符版本。 参数和 wcscat 的返回值是宽字符字符串;_mbscat 的参数和返回值为多字节字符字符串。 否则这三个函数否则具有相同行为。
在 C++ 中,这些函数具有模板重载,以调用这些函数的更新、更安全副本。 有关详细信息,请参阅安全模板重载。
一般文本例程映射
TCHAR.H 例程 |
未定义 _UNICODE & _MBCS |
已定义 _MBCS |
已定义 _UNICODE |
---|---|---|---|
_tcscat |
strcat |
_mbscat |
wcscat |
要求
例程 |
必需的标头 |
---|---|
strcat |
<string.h> |
wcscat |
<string.h> 或 <wchar.h> |
_mbscat |
<mbstring.h> |
有关兼容性的更多信息,请参见兼容性。
示例
请参见strcpy示例。
.NET Framework 等效项
请参见
参考
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