_mbsnbcat, _mbsnbcat_l

Menambahkan, paling banyak, byte n pertama dari satu string multibyte-character ke string lainnya. Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat _mbsnbcat_s, _mbsnbcat_s_l.

Penting

API ini 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

unsigned char *_mbsnbcat(
   unsigned char *dest,
   const unsigned char *src,
   size_t count
);
unsigned char *_mbsnbcat_l(
   unsigned char *dest,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
unsigned char *_mbsnbcat(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count
); // C++ only
template <size_t size>
unsigned char *_mbsnbcat_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

Parameter

dest
String tujuan multibyte-character yang dihentikan null.

src
String sumber multibyte-character yang dihentikan null.

count
Jumlah byte dari src untuk ditambahkan ke dest.

locale
Lokal untuk digunakan.

Nilai hasil

_mbsnbcat mengembalikan penunjuk ke string tujuan. Tidak ada nilai pengembalian yang dicadangkan untuk menunjukkan kesalahan.

Keterangan

Fungsi ini _mbsnbcat menambahkan, paling banyak, byte pertama count dari src ke dest. Jika byte segera mendahului karakter null di dest adalah byte prospek, byte src awal menimpa byte prospek ini. Jika tidak, byte src awal menimpa karakter destnull yang mengakhiri . Jika byte null muncul di src sebelum count byte ditambahkan, _mbsnbcat tambahkan semua byte dari src, hingga karakter null. Jika count lebih besar dari panjang src, panjang src digunakan sebagai pengganti count. String yang dihasilkan dihentikan dengan karakter null. Jika penyalinan terjadi di antara string yang tumpang tindih, perilaku tidak terdefinisi.

Nilai output dipengaruhi oleh pengaturan LC_CTYPE pengaturan kategori lokal. Untuk informasi selengkapnya, lihat setlocale . Versi _mbsnbcat fungsi menggunakan lokal saat ini untuk perilaku dependen lokal ini; _mbsnbcat_l versinya identik kecuali mereka menggunakan parameter lokal yang diteruskan sebagai gantinya. Untuk informasi selengkapnya, lihat Lokal.

Catatan Keamanan Gunakan string yang dihentikan null. String yang dihentikan null tidak boleh melebihi ukuran buffer tujuan. Untuk informasi selengkapnya, lihat Menghindari overruns buffer.

Jika dest atau src adalah NULL, fungsi akan menghasilkan kesalahan parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter. Jika kesalahan ditangani, fungsi mengembalikan EINVAL dan mengatur errno ke EINVAL.

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.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

Rutinitas Tchar.h	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tcsncat	strncat	_mbsnbcat	wcsncat
_tcsncat_l	_strncat_l	_mbsnbcat_l	_wcsncat_l

Persyaratan

Rutin	Header yang diperlukan
_mbsnbcat	<mbstring.h>
_mbsnbcat_l	<mbstring.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Baca juga

Manipulasi string
_mbsnbcmp, _mbsnbcmp_l
_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l
_mbsnbcpy, _mbsnbcpy_l
_mbsnbicmp, _mbsnbicmp_l
_mbsnbset, _mbsnbset_l
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
_mbsnbcat_s, _mbsnbcat_s_l