Fungsi IsDBCSLeadByteEx (winnls.h)

Artikel
03/08/2023

Menentukan apakah karakter yang ditentukan berpotensi menjadi byte prospek. Byte prospek adalah byte pertama dari karakter dua byte dalam kumpulan karakter byte ganda (DBCS) untuk halaman kode.

Sintaks

BOOL IsDBCSLeadByteEx(
  [in] UINT CodePage,
  [in] BYTE TestChar
);

Parameter

[in] CodePage

Pengidentifikasi halaman kode yang digunakan untuk memeriksa rentang byte prospek. Parameter ini dapat menjadi salah satu pengidentifikasi halaman kode yang ditentukan dalam Unicode dan Konstanta Set Karakter atau salah satu nilai yang telah ditentukan sebelumnya berikut. Fungsi ini memvalidasi nilai byte prospek hanya di halaman kode 932, 936, 949, 950, dan 1361.

Nilai	Makna
CP_ACP	Gunakan halaman kode Windows ANSI default sistem.
CP_MACCP	Gunakan halaman kode Macintosh default sistem.
CP_OEMCP	Gunakan halaman kode OEM default sistem.
CP_THREAD_ACP	Gunakan halaman kode ANSI Windows untuk utas saat ini.

[in] TestChar

Karakter yang akan diuji.

Nilai kembali

Mengembalikan nilai bukan nol jika byte adalah byte prospek. Fungsi mengembalikan 0 jika byte bukan byte prospek atau jika karakternya adalah karakter byte tunggal. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError.

Keterangan

Catatan Fungsi ini tidak memvalidasi keberadaan atau validitas byte jejak. Oleh karena itu, MultiByteToWideChar mungkin tidak mengenali urutan aplikasi yang menggunakan laporan IsDBCSLeadByte sebagai byte prospek. Aplikasi dapat dengan mudah menjadi tidak disinkronkan dengan hasil MultiByteToWideChar, berpotensi menyebabkan kesalahan tak terduga atau ketidakcocokan ukuran buffer.

Secara umum, alih-alih mencoba manipulasi data halaman kode tingkat rendah, aplikasi harus menggunakan MultiByteToWideChar untuk mengonversi data ke UTF-16 dan bekerja dengannya dalam pengodean tersebut.

Nilai byte prospek khusus untuk setiap DBCS yang berbeda. Beberapa nilai byte dapat muncul dalam satu halaman kode sebagai byte prospek dan jejak dari karakter DBCS. Dengan demikian, IsDBCSLeadByteEx hanya dapat menunjukkan nilai byte prospek potensial.

Untuk memahami string DBCS, aplikasi biasanya dimulai di awal string dan memindai ke depan, melacak ketika menemukan byte prospek, dan memperlakukan byte berikutnya sebagai bagian berikutnya dari karakter yang sama. Untuk mencadangkan, aplikasi harus menggunakan CharPrevExA alih-alih mencoba mengembangkan algoritmanya sendiri.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

MultiByteToWideChar

Fungsi Unicode dan Set Karakter

Unicode dan Set Karakter

WideCharToMultiByte

Share via