Fungsi StrCmpCW (shlwapi.h)

Artikel
03/02/2024

Membandingkan string menggunakan aturan kolase run-time C (ASCII). Perbandingannya peka huruf besar/kecil.

Sintaks

int StrCmpCW(
  [out] LPCWSTR pszStr1,
  [out] LPCWSTR pszStr2
);

Parameter

[out] pszStr1

Jenis: LPCTSTR

Penunjuk ke string pertama yang dihentikan null untuk dibandingkan.

[out] pszStr2

Jenis: LPCTSTR

Penunjuk ke string kedua yang dihentikan null untuk dibandingkan.

Nilai kembali

Jenis: int

Mengembalikan nol jika string identik. Mengembalikan nilai positif jika string yang ditujukkan oleh lpStr1 secara alfabet lebih besar dari yang ditujukkan oleh lpStr2. Mengembalikan nilai negatif jika string yang ditujukkan oleh lpStr1 secara alfabet lebih kecil dari yang ditujukkan oleh lpStr2.

Keterangan

Sangat disarankan agar Anda menggunakan fungsi CompareString sebagai pengganti fungsi ini. StrCmpC dirancang untuk membandingkan string kanonis. String ini tidak dilokalkan dan hanya terdiri dari karakter di bawah nilai ASCII 128. Oleh karena itu, ini tidak akan berfungsi dengan benar dengan kumpulan karakter byte ganda (DBCS) atau data beberapa karakter lainnya.

Fungsi ini menemukan karakter tidak sama pertama dan mengembalikan angka positif jika karakter dari string pertama lebih besar dari karakter dari karakter kedua, angka negatif jika kurang, atau nol jika sama. Misalnya, jika lpStr1="abczb" dan lpStr2="abcdefg", StrCmpC menentukan bahwa karakter tidak sama pertama berada di posisi empat ("z" di lpStr1 dan "d" di lpStr2) dan mengembalikan nilai positif karena kode ASCII untuk "z" lebih besar dari kode ASCII untuk "d".

Untuk versi Windows yang tidak menyertakan StrCmpC di Shlwapi.h, versi ANSI atau Unicode individual fungsi ini harus dipanggil langsung dari Shlwapi.dll. StrCmpCA adalah ordinal 155 dan StrCmpCW adalah ordinal 156.

Catatan

Header shlwapi.h mendefinisikan StrCmpC sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 5.0 atau yang lebih baru)

Lihat juga

CompareString

Bagikan melalui