strcat, wcscat, _mbscat

Articolo
06/09/2015

Accodamento di 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 ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

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.

Note

La funzione strcat aggiunge strSource a strDestination e termina la stringa risultato con un carattere null. Il carattere iniziale di strSource sovrascrive il carattere di terminazione null di strDestination. Il comportamento di strcat non è definito se le stringhe di origine e di destinazione si sovrappongono.

Nota sulla sicurezza
Poiché strcat non verifica la presenza di spazio sufficiente in strDestination prima di aggiungere strSource, è una possibile causa di sovraccarico del buffer.Invece, si consiglia di utilizzare strncat.

wcscat e _mbscat sono versioni a caratteri di tipo "wide" e di caratteri multibyte di strcat. Gli argomenti e il valore restituito di wcscat sono stringhe di caratteri di tipo "wide", quelli di _mbscat sono stringhe di caratteri multibyte. Altrimenti queste tre funzioni si comportano in modo identico.

In C++, queste funzioni presentano overload dei modelli che richiamano le relative controparti sicure e più recenti. Per ulteriori informazioni, vedere Overload di modelli sicuri.

Mapping di routine su testo generico