Share via

_setmbcp

  • Artikel

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 ke setlocale.

  • _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.

Baca juga

_getmbcp
setlocale, _wsetlocale