_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 |
Memetakan ke makro atau fungsi sebaris | _mbccpy |
Memetakan 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.
Lihat juga
Lokal
Interpretasi urutan karakter multibyte
_mbclen
, , mblen
_mblen_l