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