strcat, wcscat, _mbscat

Artikel
06/09/2015

Fügt eine Zeichenfolge an. Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu finden Sie unter strcat_s, wcscat_s, _mbscat_s.

Wichtig

_mbscat_s kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden.Weitere Informationen finden Sie unter CRT-Funktionen nicht mit /ZW unterstützt.

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

Parameter

strDestination
Auf NULL endende Zielzeichenfolge.
strSource
Mit NULL endende Quellzeichenfolge.

Rückgabewert

Jede dieser Funktionen gibt die Zielzeichenfolge zurück (strDestination). Kein Rückgabewert ist zur Fehleranzeige reserviert.

Hinweise

Die strcat-Funktion fügt strSource an strDestination an und beendet die Ergebniszeichenfolge mit einem Nullzeichen. Das erste Zeichen von strSource überschreibt das abschließende Nullzeichen von strDestination. Wenn sich Quell- und Zielzeichenfolgen überlappen, ist das Verhalten von strcat undefiniert.

Sicherheitshinweis
Da strcat vor dem Anfügen von strSourcestrDestination nicht auf genügend Speicherplatz überprüft, kann es so zu Pufferüberläufen kommen.Verwenden Sie eventuell stattdessen strncat.

wcscat und _mbscat sind Breitzeichen- und Multibytezeichenversionen von strcat. Die Argumente und der Rückgabewert von wcscat sind Breitzeichen-Zeichenfolgen; die von _mbscat sind Mehrbyte-Zeichenfolgen. Diese drei Funktionen verhalten sich andernfalls identisch.

In C++ haben diese Funktionen Vorlagenüberladungen, mit denen die neueren, sicheren Entsprechungen dieser Funktionen aufgerufen werden. Weitere Informationen finden Sie unter Sichere Vorlagenüberladungen.

Zuordnung generischer Textroutinen