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_s
nelze 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 strSource
nezkontroluje dostatek místa strDestination
, je potenciální příčinou přetečení vyrovnávací paměti. Místo toho zvažte použití strncat
.
wcscat
a _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