strcat, wcscat, _mbscat

Статья
04/10/2013

Добавление строки.Существуют более безопасные версии этих функций; см. раздел 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
Завершенная объединения строки назначения.
strSource
Объединения завершенной строка источника.

Возвращаемое значение

Каждая из этих функций возвращает строку назначения (strDestination).Возвращаемое значение не зарезервировано для отображения ошибки.

Заметки

Функция strcat добавляет strSource к strDestination, а затем к результирующей строке завершающий символ null.Начальный символ strSource перезаписывает конечный символ null strDestination.При перекрытии исходной и конечной строк поведение инструкции strcat не определено.

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

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

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

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