strcat, wcscat, _mbscat

Article
06/09/2015

Attache une chaîne. Des versions plus sécurisées de ces fonctions sont disponibles ; consultez strcat_s, wcscat_s, _mbscat_s.

Important

_mbscat_s ne peut pas être utilisée dans les applications qui s'exécutent dans le Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /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

Paramètres

strDestination
Chaîne cible finissant par Null.
strSource
Chaîne source se terminant par null.

Valeur de retour

Chacune de ces fonctions retourne la chaîne de destination (strDestination). Aucune valeur de retour n'est réservée pour indiquer une erreur.

Notes

La fonction strcat ajoute strSource à strDestination et arrête la chaîne résultante avec un caractère Null. Le caractère initial de strSource remplace le caractère null de fin de strDestination. Le comportement de strcat est non défini si les chaînes source et de destination se superposent.

Note de sécurité
Comme strcat ne vérifie pas l'espace suffisant dans strDestination avant de copier strSource, c'est une cause potentielle de dépassements de mémoire tampon.Si possible, utilisez strncat à la place.

wcscat et _mbscat sont des versions à caractères élargis et à caractères multi-octets de strcat. Les arguments et la valeur de retour de wcscat sont des chaînes à caractères larges ; ceux de _mbscat sont des chaînes de caractères multioctets. Ces trois fonctions se comportent sinon de façon identique.

En C++, ces fonctions ont des surcharges de modèle qui appellent les équivalents plus récents et sécurisés de ces fonctions. Pour plus d'informations, consultez Sécuriser les surcharges de modèle.

Mappages de routines de texte générique