Fungsi lstrcmpA (winbase.h)

Artikel
11/20/2024

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

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

Sintaksis

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

Parameter

[in] lpString1

Jenis: LPCTSTR

String pertama yang dihentikan null yang akan dibandingkan.

[in] lpString2

Jenis: LPCTSTR

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 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), 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 "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.

Nota

Header winbase.h mendefinisikan lstrcmp 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