strcat_s, wcscat_s

Nach oben zu string.h - Index

Header-Datei

string.h, _str.h

Kategorie

Routinen für Speicher- und String-Bearbeitung, Inline-Routinen

Prototyp

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);

Beschreibung

Ersetzt Strcat, mbscat, wcscat und fügt Sicherheitserweiterungen hinzu.

Hängt einen String an einen anderen an.

strcat_s hängt eine Kopie von src mit der Maximallänge destmax an das Ende von dest an. Zeichen nach '\0' werden nicht kopiert. Die Länge des Ergebnis-Strings ist strlen(dest) + strlen(src). Wenn sich src und dest überlappen, wird das Kopieren nicht durchgeführt. Bei einer Verletzung von Laufzeiteinschränkungen wird dest[0] auf Null gesetzt.

Rückgabewert

strcat_s gibt bei Erfolg Null, ansonsten Nicht-Null zurück.

Beispiel

#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ät

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

Siehe auch

• Sichere C-Bibliothek