Fungsi lstrcmpiA (winbase.h)

Artikel
03/08/2023

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

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

Sintaks

int lstrcmpiA(
  [in] LPCSTR lpString1,
  [in] LPCSTR lpString2
);

Parameter

[in] lpString1

Jenis: LPCTSTR

String pertama yang dihentikan null untuk dibandingkan.

[in] lpString2

Jenis: LPCTSTR

String kedua yang dihentikan null untuk dibandingkan.

Nilai kembali

Jenis: int

Jika string yang ditujukkan oleh lpString1 kurang dari string yang ditujukkan oleh lpString2, nilai yang dikembalikan adalah 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.

Keterangan

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 peka" 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) sistem, 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 "coop" dan "co-op" tetap bersama dalam daftar yang diurutkan. Untuk diskusi terperinci tentang pengurutan kata dan pengurutan string, lihat Menangani Pengurutan 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 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

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