_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

Yerel ayara özgü bilgileri kullanarak dizeleri karşılaştırır.

Önemli

_mbsncollve _mbsncoll_l Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.

Sözdizimi

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
);

Parametreler

string1, string2
Karşılaştırmak için null olarak sonlandırılan dizeler.

count
Karşılaştıracak karakter sayısı.

locale
Kullanılacak yerel ayar.

Dönüş değeri

Bu işlevlerin her biri, ve string2alt dizelerinin string1 ilişkisini gösteren bir değer döndürür.

Dönüş değeri	string1 ile ilişkisistring2
< 0	string1 değerinden string2küçüktür.
0	string1 ile string2aynıdır.
> 0	string1 değerinden string2büyüktür.

Bu işlevlerin her biri döndürür _NLSCMPERROR. kullanmak _NLSCMPERRORiçin STRING.h veya MBSTRING.h ekleyin. _wcsncoll veya harmanlama dizisinin etki alanı dışında olan geniş karakter kodları içeriyorsa başarısız string1string2 olabilir. Bir hata oluştuğunda olarak _wcsncoll ayarlanabilir errnoEINVAL. çağrısında _wcsncollhata olup olmadığını denetlemek için 0 olarak ayarlayın errno ve ardından aramadan _wcsncoll sonra denetleyinerrno.

Açıklamalar

Bu işlevlerin her biri, şu anda kullanımda olan kod sayfasına göre ve string2içindeki string1 ilk count karakterlerin büyük/küçük harfe duyarlı karşılaştırmasını gerçekleştirir. Bu işlevleri yalnızca, karakter kümesi sırası ile kod sayfasındaki sözcüksel karakter sırası arasında bir fark olduğunda ve bu fark dize karşılaştırması için önemli olduğunda kullanın. Karakter kümesi sırası yerel ayara bağlıdır. Bu işlevlerin son ekine sahip _l olmayan sürümleri geçerli yerel ayarı kullanır, ancak son eki olan _l sürümler geçirilen yerel ayarı kullanır. Daha fazla bilgi için bkz . Yerel Ayar.

Bu işlevlerin tümü parametrelerini doğrular. string1string2 Veya bir null işaretçiyse veya count değerinden INT_MAXbüyükse, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, bu işlevler döndürülerek _NLSCMPERROR olarak EINVALayarlanırerrno.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

TCHAR.H yordamı	_UNICODE ve _MBCS tanımlanmadı	_MBCS Tanımlanan	_UNICODE Tanımlanan
_tcsnccoll	_strncoll	_mbsncoll	_wcsncoll
_tcsncoll	_strncoll	_mbsnbcoll	_wcsncoll

Gereksinimler

Yordam	Gerekli başlık
_strncoll, _strncoll_l	<string.h>
_wcsncoll, _wcsncoll_l	<wchar.h> veya <string.h>
_mbsncoll, _mbsncoll_l	<mbstring.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Ayrıca bkz.

Yerel ayar
Dize işleme
strcoll işlevleri
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