Share via

Fungsi IsDBCSLeadByte (winnls.h)

  • Artikel

Menentukan apakah karakter yang ditentukan adalah byte prospek untuk halaman kode WINDOWS ANSI default sistem (CP_ACP). Byte prospek adalah byte pertama dari karakter dua byte dalam kumpulan karakter byte ganda (DBCS) untuk halaman kode.

Catatan Untuk menggunakan halaman kode yang berbeda, aplikasi Anda harus menggunakan fungsi IsDBCSLeadByteEx .
 

Sintaks

BOOL IsDBCSLeadByte(
  [in] BYTE TestChar
);

Parameter

[in] TestChar

Karakter yang akan diuji.

Nilai kembali

Mengembalikan nilai bukan nol jika karakter pengujian berpotensi menjadi byte prospek. Fungsi mengembalikan 0 jika karakter pengujian bukan byte prospek atau jika itu 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.

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. Jika aplikasi harus mencadangkan, aplikasi harus menggunakan CharPrev 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

IsDBCSLeadByteEx

MultiByteToWideChar

Fungsi Unicode dan Set Karakter

Unicode dan Set Karakter