Поделиться через

strcat, , wcscat_mbscat

  • Статья

Дополняет строку. Доступны более безопасные версии этих функций; see , , _mbscat_swcscat_s.strcat_s

Внимание

_mbscat_s не может использоваться в приложениях, запускаемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.

Синтаксис

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
Исходная строка, завершающаяся символом NULL.

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

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

Замечания

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

Внимание

strcat не проверяет, достаточно ли места в строке strDestination, перед добавлением strSource, в связи с чем может возникнуть ошибка переполнения буфера. Вместо этого рекомендуется использовать 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.

См. также

Обработка строк
strncat, , _strncat_l_wcsncat_lwcsncat_mbsncat,_mbsncat_l
strncmp, , wcsncmp_mbsncmp_mbsncmp_l
strncpy, , _strncpy_l_wcsncpy_lwcsncpy_mbsncpy,_mbsncpy_l
_strnicmp, , _wcsnicmp_strnicmp_l_mbsnicmp_wcsnicmp_l,_mbsnicmp_l
strrchr, , wcsrchr_mbsrchr_mbsrchr_l
strspn, , wcsspn_mbsspn_mbsspn_l