Fungsi lstrcmpiW (winbase.h)

Artikel
20/11/2024

Membandingkan dua string karakter. Perbandingan tidak peka huruf besar/kecil.

Untuk melakukan perbandingan yang peka huruf besar/kecil, gunakan fungsi lstrcmp.

Sintaksis

int lstrcmpiW(
  [in] LPCWSTR lpString1,
  [in] LPCWSTR lpString2
);

Parameter

[in] lpString1

Jenis: LPCWSTR

String pertama yang dihentikan null yang akan dibandingkan.

[in] lpString2

Jenis: LPCWSTR

String kedua yang dihentikan null untuk dibandingkan.

Mengembalikan nilai

Jenis: int

Jika string yang ditujukkan oleh lpString1 kurang dari string yang ditujukkan oleh lpString2, nilai pengembalian negatif. Jika string yang ditujukkan oleh lpString1 lebih besar dari string yang ditujukkan oleh lpString2, nilai yang dikembalikan adalah positif. Jika string sama, nilai yang dikembalikan adalah nol.

Komentar

Fungsi lstrcmpi membandingkan dua string dengan memeriksa karakter pertama satu sama lain, karakter kedua satu sama lain, dan sebagainya sampai menemukan ketidaksamaan atau mencapai akhir string.

Perhatikan bahwa parameter lpString1 dan lpString2 harus dihentikan null, jika tidak, perbandingan string dapat salah.

Fungsi ini memanggil CompareStringEx, menggunakan lokal utas saat ini, dan mengurangi 2 dari hasilnya, untuk mempertahankan konvensi run-time C untuk membandingkan string.

Untuk beberapa lokal, fungsi lstrcmpi mungkin tidak cukup. Jika ini terjadi, gunakan CompareStringEx untuk memastikan perbandingan yang tepat. Misalnya, di Jepang memanggil dengan nilai NORM_IGNORECASE, NORM_IGNOREKANATYPE, dan NORM_IGNOREWIDTH untuk mencapai perbandingan string yang tidak tepat yang paling tepat. Nilai NORM_IGNOREKANATYPE dan NORM_IGNOREWIDTH diabaikan di lokal non-Asia, sehingga Anda dapat mengatur nilai-nilai ini untuk semua lokal dan dijamin memiliki pengurutan "tidak sensitif" yang benar secara budaya terlepas dari lokalnya. Perhatikan bahwa menentukan nilai-nilai ini memperlambat performa, jadi gunakan hanya jika perlu.

Dengan versi set karakter byte ganda (DBCS), fungsi ini dapat membandingkan dua string DBCS.

Fungsi lstrcmpi menggunakan pengurutan kata, bukan pengurutan string. Pengurutan kata memperlakukan tanda hubung dan apostrof secara berbeda dari itu memperlakukan simbol lain yang tidak alfanumerik, untuk memastikan bahwa kata-kata seperti "kandang" dan "co-op" tetap bersama dalam daftar yang diurutkan. Untuk diskusi terperinci tentang pengurutan kata dan pengurutan string, lihat pengurutan Penanganan di Aplikasi Anda.

Keterangan Keamanan

Lihat Pertimbangan Keamanan: Fitur Internasional untuk pertimbangan keamanan mengenai pilihan fungsi perbandingan.

Catatan

Header winbase.h mendefinisikan lstrcmpi sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

CompareString

CompareStringEx

CompareStringOrdinal

Konseptual

Sumber Daya Lain

Referensi

String

lstrcat

lstrcmp

lstrcpy

lstrlen

Bagikan melalui