Struktur CPINFO (winnls.h)

Artikel
03/08/2023

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

Sintaks

typedef struct _cpinfo {
  UINT MaxCharSize;
  BYTE DefaultChar[MAX_DEFAULTCHAR];
  BYTE LeadByte[MAX_LEADBYTES];
} CPINFO, *LPCPINFO;

Anggota

MaxCharSize

Panjang maksimum, dalam byte, dari karakter di halaman kode. Panjangnya bisa 1 untuk kumpulan karakter byte tunggal (SBCS), 2 untuk kumpulan 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 rentang byte prospek dengan panjang tetap, 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 selengkapnya, lihat bagian Keterangan.

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 dianjurkan 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.

CPINFOEX, yang digunakan oleh fungsi GetCPInfoEx , menyediakan versi yang diperluas dari struktur ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	winnls.h (termasuk Windows.h)

Lihat juga

CPINFOEX

GetCPInfo

MultiByteToWideChar

Struktur Dukungan Bahasa Nasional

WideCharToMultiByte

Bagikan melalui