strcat, , wcscat_mbscat

Připojí řetězec. K dispozici jsou bezpečnější verze těchto funkcí; viz strcat_s, wcscat_s, _mbscat_s.

Důležité

_mbscat_snelze použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.

Syntaxe

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

Parametry

strDestination
Cílový řetězec ukončený hodnotou null.

strSource
Zdrojový řetězec ukončený hodnotou null.

Vrácená hodnota

Každá z těchto funkcí vrátí cílový řetězec (strDestination). Žádná návratová hodnota není vyhrazena k označení chyby.

Poznámky

Funkce strcat připojí strSource strDestination a ukončí výsledný řetězec znakem null. Počáteční znak strSource přepsání ukončující znak null znaku strDestination. Chování strcat není definováno, pokud se zdrojový a cílový řetězec překrývají.

Důležité

Vzhledem k tomustrcat, že před připojením strSourcenezkontroluje dostatek místa strDestination , je potenciální příčinou přetečení vyrovnávací paměti. Místo toho zvažte použití strncat .

wcscata _mbscat jsou širokoznakové a vícebajtové verze .strcat Argumenty a návratová hodnota jsou řetězce širokého znaku wcscat . Argumenty a návratová _mbscat hodnota jsou řetězce s vícebajtovými znaky. Tyto tři funkce se chovají stejně jinak.

V jazyce C++ mají tyto funkce přetížení šablon, které vyvolávají novější zabezpečené protějšky těchto funkcí. Další informace naleznete v tématu Přetížení šablon zabezpečení.

Mapování rutin obecného textu

TCHAR.H rutina	_UNICODE a _MBCS není definován	_MBCS definovaný	_UNICODE definovaný
_tcscat	strcat	_mbscat	wcscat

Požadavky

Rutina	Požadovaný hlavičkový soubor
strcat	<string.h>
wcscat	<string.h> nebo <wchar.h>
_mbscat	<mbstring.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad

Podívejte se na příklad pro strcpy.

Viz také

Manipulace s řetězci
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