strcat, wcscat, _mbscat

Article
03/26/2013

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

Important

_mbscat_s ne peut pas être utilisé dans les applications qui s'exécutent dans les fenêtres d'exécution.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 de destination se terminant par null.
strSource
Chaîne se terminant par null source.

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 d' strcat ajoute strSource à strDestination et se termine la chaîne obtenue avec un caractère Null.Le caractère initial d' strSource remplace le caractère NULL de fin d' strDestination.Le comportement d' strcat n'est pas défini si la source et les chaînes de destination se chevauchent.

Note de sécurité
Étant donné qu' strcat ne vérifie pas suffisamment d'espace dans strDestination avant d'ajouter strSource, c'est une erreur potentielle des dépassements de mémoire tampon.Utilisez strncat à la place.

wcscat et _mbscat sont à caractères larges et des versions à caractères multioctets d' strcat.Les arguments et la valeur de retour d' wcscat sont des chaînes à caractères larges ; ces d' _mbscat sont des chaînes de caractères multioctets.Ces trois fonctions se comportent de sinon.

En C++, ces fonctions ont des surcharges de modèle qui appellent le plus récent, fixent des équivalents de ces fonctions.Pour plus d'informations, consultez Surcharges sécurisées de modèle.

Mappages de routines de texte générique