strcat, , wcscat_mbscat

Menambahkan string. Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat strcat_s, wcscat_s, _mbscat_s.

Penting

_mbscat_s tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.

Sintaks

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
String tujuan yang dihentikan null.

strSource
String sumber yang dihentikan null.

Nilai hasil

Masing-masing fungsi ini mengembalikan string tujuan (strDestination). Tidak ada nilai pengembalian yang dicadangkan untuk menunjukkan kesalahan.

Keterangan

Fungsi menambahkan strcat strSource dan strDestination mengakhiri string yang dihasilkan dengan karakter null. Karakter awal menimpa strSource karakter strDestinationnull yang mengakhiri . Perilaku strcat tidak terdefinisi jika string sumber dan tujuan tumpang tindih.

Penting

Karena strcat tidak memeriksa ruang yang cukup sebelum strDestination menambahkan strSource, itu adalah penyebab potensial overruns buffer. Pertimbangkan untuk menggunakan strncat sebagai gantinya.

wcscat dan _mbscat adalah versi karakter lebar dan multibyte-character dari strcat. Argumen dan nilai yang dikembalikan adalah wcscat string karakter lebar. Argumen dan nilai yang dikembalikan adalah _mbscat string multibyte-character. Ketiga fungsi ini berulah secara identik jika tidak.

Di C++, fungsi-fungsi ini memiliki kelebihan beban templat yang memanggil rekan-rekan yang lebih baru dan aman dari fungsi-fungsi ini. Untuk informasi selengkapnya, lihat Mengamankan kelebihan beban templat.

Pemetaan rutin teks generik

TCHAR.H Rutin	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tcscat	strcat	_mbscat	wcscat

Persyaratan

Rutin	Header yang diperlukan
strcat	<string.h>
wcscat	<string.h> atau <wchar.h>
_mbscat	<mbstring.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Lihat contoh untuk strcpy.

Lihat juga

Manipulasi string
strncat, , _strncat_lwcsncat, _wcsncat_l, , _mbsncat,_mbsncat_l
strncmp, , wcsncmp_mbsncmp,_mbsncmp_l
strncpy, , _strncpy_lwcsncpy, _wcsncpy_l, , _mbsncpy,_mbsncpy_l
_strnicmp, , _wcsnicmp_mbsnicmp, _strnicmp_l, , _wcsnicmp_l,_mbsnicmp_l
strrchr, , wcsrchr_mbsrchr,_mbsrchr_l
strspn, , wcsspn_mbsspn,_mbsspn_l