Fungsi StrCmpNICW (shlwapi.h)
Membandingkan jumlah karakter tertentu dari awal dua string menggunakan aturan kolase run-time C (ASCII). Perbandingannya tidak peka huruf besar/kecil.
Sintaks
int StrCmpNICW(
[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.
Menampilkan 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 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 StrCmpNIC 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. StrCmpNIC 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 StrCmpNIC di Shlwapi.h, versi ANSI atau Unicode individual fungsi ini harus dipanggil langsung dari Shlwapi.dll. StrCmpNICA adalah ordinal 153 dan StrCmpNICW adalah ordinal 154.
Catatan
Header shlwapi.h mendefinisikan StrCmpNIC 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
| 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) |