_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

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

Önemli

_mbsnicollve _mbsnicoll_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 _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
);

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 aşağıdaki gibi ve string2alt dizelerinin string1 ilişkisini gösteren bir değer döndürür.

Dönüş değeri	Dize1 ile dize2 ilişkisi
< 0	string1 küçüktür string2
0	string1 özdeş string2
> 0	string1 büyüktür string2

Bu işlevlerin her biri döndürür _NLSCMPERROR. kullanmak _NLSCMPERRORiçin DIZE'yi ekleyin. H veya MBSTRING.H. _wcsnicoll veya harmanlama dizisinin etki alanı dışında geniş karakter kodları içeriyorsa başarısız string1string2 olabilir. Bir hata oluştuğunda olarak _wcsnicoll ayarlanabilir errnoEINVAL. çağrısında _wcsnicollhata olup olmadığını denetlemek için 0 olarak ayarlayın errno ve çağrısı _wcsnicollyaptıktan sonra denetleyinerrno.

Açıklamalar

Bu işlevlerin her biri, içindeki ve string2 kod sayfasına göre ilk count karakterlerin string1 büyük/küçük harfe duyarsız bir karşılaştırmasını gerçekleştirir. Bu işlevler yalnızca kod sayfasındaki karakter kümesi sırası ile sözcüksel karakter sırası arasında bir fark olduğunda kullanılmalıdır ve bu fark dize karşılaştırması için önemlidir. Bu işlevlerin son eki olmayan _l sürümleri geçerli yerel ayarı ve kod sayfasını kullanır. Son eki olan _l sürümler, bunun yerine geçirilen yerel ayarı kullanmaları dışında aynıdır. Daha fazla bilgi için bkz . Yerel Ayar.

Bu işlevlerin tümü parametrelerini doğrular. string1string2 veya null işaretçiyse veya sayı 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
_tcsncicoll	_strnicoll	_mbsnbicoll	_wcsnicoll
_tcsnicoll	_strnicoll	_mbsnbicoll	_wcsnicoll
_tcsnicoll_l	_strnicoll_l	_mbsnbicoll_l	_wcsnicoll_l

Gereksinimler

Yordam	Gerekli başlık
_strnicoll, _strnicoll_l	<string.h>
_wcsnicoll, _wcsnicoll_l	<wchar.h> veya <string.h>
_mbsnicoll, _mbsnicoll_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