strcat
, wcscat
, _mbscat
Aggiunge una stringa. Sono disponibili versioni più sicure di queste funzioni; vedere strcat_s
, wcscat_s
, _mbscat_s
.
Importante
_mbscat_s
non può essere utilizzato in applicazioni che vengono eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).
Sintassi
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
Parametri
strDestination
Stringa di destinazione con terminazione Null.
strSource
Stringa di origine con terminazione null.
Valore restituito
Ognuna di queste funzioni restituisce la stringa di destinazione (strDestination
). Nessun valore restituito è riservato per indicare un errore.
Osservazioni:
La funzione strcat
aggiunge strSource
a strDestination
e termina la stringa risultante con un carattere Null. Il carattere iniziale di strSource
sovrascrive il carattere Null di terminazione di strDestination
. Se le stringhe di origine e di destinazione si sovrappongono, il comportamento di strcat
non è definito.
Importante
strcat
non verifica la presenza di spazio sufficiente in strDestination
prima di aggiungere strSource
, quindi è una causa possibile di sovraccarichi del buffer. In alternativa, considerare l'utilizzo di strncat
.
wcscat
e _mbscat
sono versioni con caratteri wide e caratteri multibyte di strcat
. Gli argomenti e il valore restituito di sono stringhe di wcscat
caratteri wide. Gli argomenti e il valore restituito di sono stringhe di _mbscat
caratteri multibyte. A parte ciò, queste tre funzioni si comportano in modo identico.
In C++ queste funzioni presentano overload di modello che richiamano le relative controparti più recenti e sicure. Per altre informazioni, vedere Proteggere gli overload dei modelli.
Mapping di routine di testo generico
TCHAR.H routine |
_UNICODE e _MBCS non definito |
_MBCS definito |
_UNICODE definito |
---|---|---|---|
_tcscat |
strcat |
_mbscat |
wcscat |
Requisiti
Ciclo | Intestazione obbligatoria |
---|---|
strcat |
<string.h> |
wcscat |
<string.h> oppure <wchar.h> |
_mbscat |
<mbstring.h> |
Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).
Esempio
Vedere l'esempio per strcpy
.
Vedi anche
Manipolazione delle stringhe
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