Struktur CPINFOEXA (winnls.h)

Artikel
08/27/2023

Berisi informasi tentang halaman kode. Struktur ini digunakan oleh fungsi GetCPInfoEx .

Sintaks

typedef struct _cpinfoexA {
  UINT  MaxCharSize;
  BYTE  DefaultChar[MAX_DEFAULTCHAR];
  BYTE  LeadByte[MAX_LEADBYTES];
  WCHAR UnicodeDefaultChar;
  UINT  CodePage;
  CHAR  CodePageName[MAX_PATH];
} CPINFOEXA, *LPCPINFOEXA;

Anggota

MaxCharSize

Panjang maksimum, dalam byte, dari karakter di halaman kode. Panjangnya bisa 1 untuk kumpulan karakter byte tunggal (SBCS), 2 untuk set karakter byte ganda (DBCS), atau nilai yang lebih besar dari 2 untuk jenis kumpulan karakter lainnya. Fungsi tidak dapat menggunakan ukuran untuk membedakan SBCS atau DBCS dari set karakter lain karena faktor lain, misalnya, penggunaan halaman kode ISCII atau ISO-2022-xx.

DefaultChar[MAX_DEFAULTCHAR]

Karakter default yang digunakan saat menerjemahkan string karakter ke halaman kode tertentu. Karakter ini digunakan oleh fungsi WideCharToMultiByte jika karakter default eksplisit tidak ditentukan. Defaultnya biasanya adalah karakter "?" untuk halaman kode.

LeadByte[MAX_LEADBYTES]

Array panjang tetap rentang byte prospek, yang jumlah rentang byte prospeknya bervariasi. Jika halaman kode tidak memiliki byte prospek, setiap elemen array diatur ke NULL. Jika halaman kode memiliki byte prospek, array menentukan nilai awal dan nilai akhir untuk setiap rentang. Rentang bersifat inklusif, dan jumlah maksimum rentang untuk halaman kode apa pun adalah lima. Array menggunakan dua byte untuk menjelaskan setiap rentang, dengan dua byte null sebagai terminator setelah rentang terakhir.

Catatan Beberapa halaman kode menggunakan byte prospek dan kombinasi mekanisme pengodean lainnya. Anggota ini biasanya hanya diisi untuk subset halaman kode yang menggunakan byte prospek dalam beberapa formulir. Untuk informasi lebih lanjut, lihat bagian Keterangan.

UnicodeDefaultChar

Karakter default Unicode yang digunakan dalam terjemahan dari halaman kode tertentu. Defaultnya biasanya adalah karakter "?" atau karakter titik tengah katakana. Karakter default Unicode digunakan oleh fungsi MultiByteToWideChar .

CodePage

Nilai halaman kode. Nilai ini mencerminkan halaman kode yang diteruskan ke fungsi GetCPInfoEx . Lihat Pengidentifikasi Halaman Kode untuk daftar ANSI dan halaman kode lainnya.

CodePageName[MAX_PATH]

Nama lengkap halaman kode. Perhatikan bahwa nama ini dilokalkan dan tidak dijamin keunikan atau konsistensi antara versi sistem operasi atau komputer.

Keterangan

Byte prospek unik untuk halaman kode DBCS yang memungkinkan lebih dari 256 karakter. Byte prospek adalah byte pertama dari karakter 2-byte dalam DBCS. Pada setiap halaman kode DBCS, byte prospek menempati rentang nilai byte tertentu. Rentang ini berbeda untuk halaman kode yang berbeda.

Informasi byte prospek tidak terlalu membantu untuk sebagian besar halaman kode, dan bahkan tidak disediakan untuk banyak pengodean multi-byte, misalnya, UTF-8 dan GB18030. Aplikasi Anda tidak disarankan untuk menggunakan informasi ini untuk memprediksi apa yang akan dilakukan fungsi MultiByteToWideChar atau WideCharToMultiByte . Fungsi mungkin berakhir menggunakan karakter default atau melakukan perilaku default lainnya jika byte yang mengikuti byte prospek tidak seperti yang diharapkan.

Catatan

Header winnls.h mendefinisikan CPINFOEX sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Header	winnls.h (termasuk Windows.h)

Lihat juga

GetCPInfoEx

MultiByteToWideChar

Struktur Dukungan Bahasa Nasional

WideCharToMultiByte

Bagikan melalui