Fungsi StrCmpNCW (shlwapi.h)
Membandingkan jumlah karakter tertentu dari awal dua string menggunakan aturan kolase run-time C (ASCII). Perbandingannya peka huruf besar/kecil.
Sintaks
int StrCmpNCW(
[in] LPCWSTR pszStr1,
[in] LPCWSTR pszStr2,
int nChar
);
Parameter
[in] pszStr1
Jenis: LPCTSTR
Penunjuk ke string pertama yang dihentikan null untuk dibandingkan.
[in] pszStr2
Jenis: LPCTSTR
Penunjuk ke string kedua yang dihentikan null untuk dibandingkan.
nChar
Jenis: int
Jumlah karakter dari awal setiap string yang akan dibandingkan.
Mengembalikan nilai
Jenis: int
Mengembalikan nol jika substring identik. Mengembalikan nilai positif jika string yang diambil dari yang ditujukan ke oleh pszStr1 secara alfabet lebih besar dari string yang diambil dari yang menunjuk ke oleh pszStr2. Mengembalikan nilai negatif jika string yang diambil dari yang ditujukan oleh pszStr1 secara alfabet lebih kecil dari string yang diambil dari yang menunjuk ke oleh pszStr2.
Keterangan
Perhatikan bahwa StrCmpNC 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 yang kedua, angka negatif jika kurang, atau nol jika sama. Misalnya, misalkan pszStr1="abczb", pszStr2="abcdefg", dan Anda membandingkan empat karakter pertama dari masing-masing karakter. StrCmpNC menentukan bahwa karakter tidak sama pertama berada di posisi empat ("z" di pszStr1 dan "d" di pszStr2) dan mengembalikan nilai positif karena kode ASCII untuk "z" lebih besar dari kode ASCII untuk "d".
Untuk versi Windows yang tidak menyertakan StrCmpNC di Shlwapi.h, versi ANSI atau Unicode individual fungsi ini harus dipanggil langsung dari Shlwapi.dll. StrCmpNCA adalah ordinal 151 dan StrCmpNCW adalah ordinal 152.
Catatan
Header shlwapi.h mendefinisikan StrCmpNC 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, 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) |