Fungsi StrCmpCW (shlwapi.h)

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

Sintaksis

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.

Mengembalikan nilai

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 ke lpStr2.

Komentar

Sangat disarankan agar Anda menggunakan fungsi CompareString menggantikan 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 set 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 yang 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" dalam lpStr1 dan "d" dalam 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.

Persyaratan

Lihat juga

CompareString