_strnicoll
, _wcsnicoll
, _mbsnicoll
, _strnicoll_l
, _wcsnicoll_l
, _mbsnicoll_l
Membandingkan string dengan menggunakan informasi khusus lokal.
Penting
_mbsnicoll
dan _mbsnicoll_l
tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.
Sintaks
int _strnicoll(
const char *string1,
const char *string2,
size_t count
);
int _wcsnicoll(
const wchar_t *string1,
const wchar_t *string2 ,
size_t count
);
int _mbsnicoll(
const unsigned char *string1,
const unsigned char *string2,
size_t count
);
int _strnicoll_l(
const char *string1,
const char *string2,
size_t count,
_locale_t locale
);
int _wcsnicoll_l(
const wchar_t *string1,
const wchar_t *string2 ,
size_t count,
_locale_t locale
);
int _mbsnicoll_l(
const unsigned char *string1,
const unsigned char *string2,
size_t count,
_locale_t locale
);
Parameter
string1
, string2
String yang dihentikan null untuk dibandingkan
count
Jumlah karakter yang akan dibandingkan
locale
Lokal yang akan digunakan.
Nilai hasil
Masing-masing fungsi ini mengembalikan nilai yang menunjukkan hubungan substring string1
dan string2
, sebagai berikut.
Nilai hasil | Hubungan string1 ke string2 |
---|---|
< 0 | string1 Kurang string2 |
0 | string1 identik dengan string2 |
> 0 | string1 lebih besar dari string2 |
Masing-masing fungsi ini mengembalikan _NLSCMPERROR
. Untuk menggunakan _NLSCMPERROR
, sertakan salah satu STRING. H atau MBSTRING.H. _wcsnicoll
dapat gagal jika salah satu string1
atau string2
berisi kode karakter lebar di luar domain urutan kolase. Ketika kesalahan terjadi, _wcsnicoll
dapat diatur errno
ke EINVAL
. Untuk memeriksa kesalahan pada panggilan ke , atur ke _wcsnicoll
0 lalu periksa errno
setelah memanggil _wcsnicoll
.errno
Keterangan
Masing-masing fungsi ini melakukan perbandingan karakter pertama count
yang tidak peka huruf besar/kecil dan string1
string2
sesuai dengan halaman kode. Fungsi-fungsi ini harus digunakan hanya ketika ada perbedaan antara urutan set karakter dan urutan karakter leksikografis di halaman kode dan perbedaan ini menarik untuk perbandingan string. Versi fungsi ini tanpa akhiran _l
menggunakan halaman lokal dan kode saat ini. Versi dengan akhiran _l
identik kecuali mereka menggunakan lokal yang diteruskan sebagai gantinya. Untuk informasi selengkapnya, lihat Lokal.
Semua fungsi ini memvalidasi parameternya. Jika atau string1
string2
adalah penunjuk null, atau jika jumlah lebih besar dari INT_MAX
, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter . Jika eksekusi diizinkan untuk melanjutkan, fungsi-fungsi ini kembali _NLSCMPERROR
dan diatur errno
ke EINVAL
.
Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.
Pemetaan rutin teks generik
TCHAR. Rutinitas H | _UNICODE dan _MBCS tidak ditentukan |
_MBCS Didefinisikan |
_UNICODE Didefinisikan |
---|---|---|---|
_tcsncicoll |
_strnicoll |
_mbsnbicoll |
_wcsnicoll |
_tcsnicoll |
_strnicoll |
_mbsnbicoll |
_wcsnicoll |
_tcsnicoll_l |
_strnicoll_l |
_mbsnbicoll_l |
_wcsnicoll_l |
Persyaratan
Rutin | Header yang diperlukan |
---|---|
_strnicoll , _strnicoll_l |
<string.h> |
_wcsnicoll , _wcsnicoll_l |
<wchar.h> atau <string.h> |
_mbsnicoll , _mbsnicoll_l |
<mbstring.h> |
Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.
Baca juga
Lokal
Manipulasi string
strcoll
Fungsi
localeconv
_mbsnbcoll
, _mbsnbcoll_l
, _mbsnbicoll
, _mbsnbicoll_l
setlocale
, _wsetlocale
strcmp
, wcscmp
, _mbscmp
_stricmp
, _wcsicmp
, _mbsicmp
, _stricmp_l
, _wcsicmp_l
, _mbsicmp_l
strncmp
, wcsncmp
, _mbsncmp
, _mbsncmp_l
_strnicmp
, _wcsnicmp
, _mbsnicmp
, _strnicmp_l
, _wcsnicmp_l
, _mbsnicmp_l
strxfrm
, wcsxfrm
, _strxfrm_l
, _wcsxfrm_l
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk