strcat_s, wcscat_s

Remonter à string.h - Index

Fichier en-tête

string.h, _str.h

Catégorie

Routines de mémoire et de manipulation de chaînes, routines inline

Prototype

errno_t *strcat(char * _RESTRICT dest, rsize_t destmax, const char * _RESTRICT src);

errno_t *wcscat(wchar_t * _RESTRICT dest, rsize_t destmax, const wchar_t * _RESTRICT src);

Description

Remplace Strcat, mbscat, wcscat en ajoutant des améliorations relatives à la sécurité.

Ajoute une chaîne à une autre.

strcat_s ajoute une copie limitée en taille par destmax de src à la fin de dest. Les caractères suivant '\0' ne sont pas copiés. La longueur de la chaîne résultante est strlen(dest) + strlen(src). Si src et dest se chevauchent, la copie n'est pas effectuée. Si une violation de contrainte d'exécution se produit, dest[0] est alors défini sur null.

Valeur renvoyée

strcat_s renvoie zéro en cas de succès. Sinon, une valeur différente de zéro est renvoyée.

Exemple

#include <string.h>
#include <stdio.h>
int main(void)
{
   char destination[25];
   char *c = "C++";
   char *Embarcadero = "Embarcadero";
   strcpy_s(destination, 12, Embarcadero);
   strcat_s(destination, 20, c);
   printf("%s\n", destination);
   return 0;
}

Portabilité

	POSIX	Win32	ANSI C	ANSI C++
strcat_s	+	+	+	+
wcscat_s		+	+	+

Voir aussi

• Bibliothèque C sécurisante