Udostępnij za pośrednictwem

strcat, , wcscat_mbscat

  • Artykuł

Dołącza ciąg. Dostępne są bezpieczniejsze wersje tych funkcji; zobacz , , _mbscat_swcscat_s.strcat_s

Ważne

_mbscat_snie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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

Parametry

strDestination
Ciąg docelowy zakończony wartością null.

strSource
Ciąg źródłowy zakończony wartością null.

Wartość zwracana

Każda z tych funkcji zwraca ciąg docelowy (strDestination). Żadna wartość zwracana nie jest zarezerwowana, aby wskazać błąd.

Uwagi

Funkcja strcat dołącza strSource i strDestination kończy wynikowy ciąg znakiem null. Początkowy znak strSource zastępowania kończącego znak null .strDestination Zachowanie elementu strcat jest niezdefiniowane, jeśli ciągi źródłowe i docelowe nakładają się na siebie.

Ważne

Ponieważ strcat nie sprawdza wystarczającej ilości miejsca strDestination przed dołączeniem , jest to potencjalna przyczyna przepełnień strSourcebuforu. Rozważ użycie strncat zamiast tego.

wcscati _mbscat są wersjami znaków wielobajtowych i wielobajtowych .strcat Argumenty i wartość zwracana wcscat wartości to ciągi wieloznakowe. Argumenty i wartość zwracana wartości to ciągi wielobajtowe _mbscat znaków. Te trzy funkcje zachowują się identycznie inaczej.

W języku C++te funkcje mają przeciążenia szablonu, które wywołują nowsze, bezpieczne odpowiedniki tych funkcji. Aby uzyskać więcej informacji, zobacz Bezpieczne przeciążenia szablonów.

Mapowania procedur tekstu ogólnego

TCHAR.H rutyna _UNICODE i _MBCS niezdefiniowane _MBCS zdefiniowany _UNICODE zdefiniowany
_tcscat strcat _mbscat wcscat

Wymagania

Procedura Wymagany nagłówek
strcat <string.h>
wcscat <string.h> lub <wchar.h>
_mbscat <mbstring.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

Zobacz przykład dla elementu strcpy.

Zobacz też

Manipulowanie ciągami
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