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 vor dem Anfügen von strDestinationstrSource nicht auf genügend Speicherplatz überprüft, kann es so zu Pufferüberläufen kommen. Verwenden Sie stattdessen strncat.

wcscat und _mbscat sind Breitzeichen- und Multibytezeichenversionen von strcat. Die Argumente und der Rückgabewert von wcscat sind Breitzeichenzeichenfolgen. Die Argumente und der Rückgabewert von _mbscat sind Multibyte-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 Schützen von Vorlagenüberladungen.

Generische Textroutinenzuordnungen

TCHAR.H Routine	_UNICODE und _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>

Weitere Informationen zur Kompatibilität finden Sie unter Compatibility.

Beispiel

Sehen Sie sich das Beispiel für strcpyan.

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