Fungsi lstrcmpA (winbase.h)

Artikel
08/27/2023

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

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

Sintaks

int lstrcmpA(
  [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 lstrcmp 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.

Bahasa (lokal pengguna) yang dipilih oleh pengguna pada waktu penyiapan, atau melalui Panel Kontrol, menentukan string mana yang lebih besar (atau apakah stringnya sama). Jika tidak ada bahasa (lokal pengguna) yang dipilih, sistem melakukan perbandingan dengan menggunakan nilai default.

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

Fungsi lstrcmp 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 lstrcmp 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