_mbccpy, _mbccpy_l

Menyalin karakter multibyte dari satu string ke string lain. Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat _mbccpy_s, _mbccpy_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

void _mbccpy(
   unsigned char *dest,
   const unsigned char *src
);
void _mbccpy_l(
   unsigned char *dest,
   const unsigned char *src,
   _locale_t locale
);

Parameter

dest
Salin tujuan.

src
Karakter multibyte untuk disalin.

locale
Lokal untuk digunakan.

Keterangan

Fungsi _mbccpy menyalin satu karakter multibyte dari src ke dest.

Fungsi ini memvalidasi parameternya. Jika _mbccpy diteruskan penunjuk null untuk dest atau src, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, errno diatur ke EINVAL.

_mbccpy menggunakan lokal saat ini untuk perilaku dependen lokal apa pun. _mbccpy_l identik dengan _mbccpy kecuali yang menggunakan lokal yang _mbccpy_l diteruskan untuk perilaku yang bergantung pada lokal. 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. Masalah buffer overrun adalah metode serangan sistem yang sering, yang mengakibatkan peningkatan hak istimewa yang tidak beralasan.

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
_tccpy	Peta ke makro atau fungsi sebaris	_mbccpy	Peta ke makro atau fungsi sebaris
_tccpy_l	n/a	_mbccpy_l	n/a

Persyaratan

Rutin	Header yang diperlukan
_mbccpy	<mbctype.h>
_mbccpy_l	<mbctype.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Baca juga

Lokal
Interpretasi urutan karakter multibyte
_mbclen, mblen, _mblen_l