strcat, wcscat, _mbscat

Статья
06/09/2015

Добавляет строку. Существуют более безопасные версии этих функций; см. раздел strcat_s, wcscat_s, _mbscat_s.

Важно!

_mbscat_s невозможно использовать в приложениях, запускаемых в среде выполнения Windows.Дополнительные сведения см. в статье Функции 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 перезаписывает конечный символ null strDestination. При перекрытии исходной и конечной строк поведение инструкции strcat не определено.

Примечание по безопасности
Поскольку strcat не проверяет наличие достаточного места в strDestination перед добавлением strSource, эта функция является потенциальной причиной переполнение буфера.Попробуйте вместо нее использовать strncat.

wcscat и _mbscat — двубайтовая и многобайтовая символьные версии strcat. Аргументы и возвращаемое значение wcscat представляют собой двухбайтовые строки; аргументы и возвращаемое значение _mbscat представляют собой многобайтовые строки. В остальных случаях эти три функции ведут себя идентично.

В C++ эти функции имеют шаблонные перегрузки, которые вызывают более новые и безопасные аналоги этих функций. Дополнительные сведения см. в разделе Безопасные перегрузки шаблонов.

Универсальное текстовое сопоставление функций