Fungsi StrCmpNCA (shlwapi.h)
Membandingkan jumlah karakter tertentu dari awal dua string menggunakan aturan kolase run-time C (ASCII). Perbandingannya peka huruf besar/kecil.
Sintaks
int StrCmpNCA(
[in] LPCSTR pszStr1,
[in] LPCSTR 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 ditujukkan oleh pszStr1 secara alfabet lebih besar dari string yang diambil dari yang diajuk oleh pszStr2. Mengembalikan nilai negatif jika string yang diambil dari yang diajukan oleh pszStr1 secara alfabet lebih kecil dari string yang diambil dari yang diajuk 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 karakter 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" dalam pszStr1 dan "d" dalam 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
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) |