_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

Membandingkan string dengan menggunakan informasi khusus lokal.

Penting

_mbsncoll dan _mbsncoll_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 _strncoll(
   const char *string1,
   const char *string2,
   size_t count
);
int _wcsncoll(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count
);
int _mbsncoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count
);
int _strncoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsncoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsncoll_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 ke string1string2
< 0	string1 kurang dari string2.
0	string1 identik dengan string2.
> 0	string1 lebih besar dari string2.

Masing-masing fungsi ini mengembalikan _NLSCMPERROR. Untuk menggunakan _NLSCMPERROR, sertakan STRING.h atau MBSTRING.h. _wcsncoll dapat gagal jika salah satu string1 atau string2 berisi kode karakter lebar yang berada di luar domain urutan kolase. Ketika kesalahan terjadi, _wcsncoll dapat diatur errno ke EINVAL. Untuk memeriksa kesalahan pada panggilan ke , atur errno ke _wcsncoll0, lalu periksa errno setelah _wcsncoll panggilan.

Keterangan

Masing-masing fungsi ini melakukan perbandingan karakter pertama count yang peka huruf besar/kecil di string1 dan string2, sesuai dengan halaman kode yang saat ini sedang digunakan. Gunakan fungsi-fungsi ini hanya ketika ada perbedaan antara urutan set karakter dan urutan karakter leksikografis di halaman kode, dan ketika perbedaan ini penting untuk perbandingan string. Urutan set karakter bergantung pada lokal. Versi fungsi ini yang tidak memiliki _l akhiran menggunakan lokal saat ini, tetapi versi yang memiliki _l akhiran menggunakan lokal yang diteruskan. Untuk informasi selengkapnya, lihat Lokal.

Semua fungsi ini memvalidasi parameternya. Jika atau string1string2 adalah penunjuk null, atau count 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
_tcsnccoll	_strncoll	_mbsncoll	_wcsncoll
_tcsncoll	_strncoll	_mbsnbcoll	_wcsncoll

Persyaratan

Rutin	Header yang diperlukan
_strncoll, _strncoll_l	<string.h>
_wcsncoll, _wcsncoll_l	<wchar.h> atau <string.h>
_mbsncoll, _mbsncoll_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