strcat
, wcscat
, _mbscat
Ajoute une chaîne. Des versions plus sécurisées de ces fonctions sont disponibles ; voir strcat_s
, wcscat_s
, _mbscat_s
.
Important
La fonction _mbscat_s
ne peut pas être utilisée dans les applications qui s’exécutent dans Windows Runtime. Pour plus d’informations, consultez Fonctions CRT non prises en charge dans les applications de la plateforme Windows universelle.
Syntaxe
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 un caractère Null.
strSource
Chaîne source se terminant par Null.
Valeur retournée
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 termine la chaîne obtenue par un caractère Null. Le caractère initial de strSource
remplace le caractère Null de fin de strDestination
. Le comportement de strcat
n'est pas défini si les chaînes source et de destination se chevauchent.
Important
Comme strcat
ne vérifie pas si strDestination
contient suffisamment d’espace avant d’ajouter strSource
, il s’agit d’une cause potentielle de dépassements de mémoire tampon. Utilisez strncat
à la place.
wcscat
et _mbscat
sont des versions à caractères larges et à caractères multioctets de strcat
. Les arguments et la valeur de retour sont wcscat
des chaînes à caractères larges. Les arguments et la valeur de retour sont _mbscat
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 Surcharges de modèles sécurisés.
Mappages de routine de texte générique
TCHAR.H Routine |
_UNICODE et _MBCS non défini |
_MBCS Défini |
_UNICODE Défini |
---|---|---|---|
_tcscat |
strcat |
_mbscat |
wcscat |
Spécifications
Routine | En-tête requis |
---|---|
strcat |
<string.h> |
wcscat |
<string.h> ou <wchar.h> |
_mbscat |
<mbstring.h> |
Pour plus d’informations sur la compatibilité, consultez Compatibility.
Exemple
Consultez l’exemple pour strcpy
.
Voir aussi
Manipulation de chaîne
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour