strcat, wcscat, _mbscat

Fügt eine Zeichenfolge an. Sicherere Versionen dieser Funktionen sind verfügbar. siehe 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 im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).

Syntax

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.

Bemerkungen

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.

Wichtig

Da strcat nicht vor dem Anfügen von strSource auf genügend Speicherplatz in der StrDestination überprüft, ist dies eine mögliche Ursache für Pufferüberläufe. Verwenden Sie 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

TCHAR.H Routine _UNICODE&_MBCS nicht definiert _MBCS Definiert _UNICODE Definiert
_tcscat strcat _mbscat wcscat

Anforderungen

-Routine zurückgegebener Wert Erforderlicher Header
strcat <string.h>
wcscat <string.h> oder <wchar.h>
_mbscat <mbstring.h>

Zusätzliche Informationen zur Kompatibilität finden Sie unter Compatibility.

Beispiel

Weitere Informationen finden Sie im Beispiel für strcpy.

Siehe auch

Zeichenfolgenbearbeitung
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