_setmbcp
Mengatur halaman kode multibyte baru.
Sintaks
int _setmbcp(
int codepage
);
Parameter
codepage
Pengaturan halaman kode baru untuk rutinitas multibyte independen lokal.
Nilai hasil
Mengembalikan 0 jika halaman kode berhasil diatur. Jika nilai halaman kode yang tidak valid disediakan untuk codepage
, mengembalikan -1 dan pengaturan halaman kode tidak berubah. errno
Diatur ke EINVAL
jika terjadi kegagalan alokasi memori.
Keterangan
Fungsi menentukan _setmbcp
halaman kode multibyte baru. Secara default, sistem run-time secara otomatis mengatur halaman kode multibyte ke halaman kode ANSI default sistem. Pengaturan halaman kode multibyte memengaruhi semua rutinitas multibyte yang tidak bergantung pada lokal. Namun, dimungkinkan untuk menginstruksikan _setmbcp
untuk menggunakan halaman kode yang ditentukan untuk lokal saat ini (lihat daftar konstanta manifes berikut dan hasil perilaku terkait). Untuk daftar rutinitas multibyte yang bergantung pada halaman kode lokal daripada halaman kode multibyte, lihat Interpretasi urutan karakter multibyte.
Argumen codepage
dapat diatur ke salah satu nilai berikut:
_MB_CP_ANSI
Gunakan halaman kode ANSI yang diperoleh dari sistem operasi pada startup program._MB_CP_LOCALE
Gunakan halaman kode lokal saat ini yang diperoleh dari panggilan sebelumnya kesetlocale
._MB_CP_OEM
Gunakan halaman kode OEM yang diperoleh dari sistem operasi saat pengaktifan program._MB_CP_SBCS
Gunakan halaman kode byte tunggal. Ketika halaman kode diatur ke_MB_CP_SBCS
, rutinitas seperti_ismbblead
selalu mengembalikan false._MB_CP_UTF8
Gunakan UTF-8. Ketika halaman kode diatur ke_MB_CP_UTF8
, rutinitas seperti_ismbblead
selalu mengembalikan false.Nilai halaman kode valid lainnya, terlepas dari apakah nilainya adalah ANSI, OEM, atau halaman kode lain yang didukung sistem operasi (kecuali UTF-7, yang tidak didukung).
Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.
Persyaratan
Rutin | Header yang diperlukan |
---|---|
_setmbcp |
<mbctype.h> |
Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.