_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Makale
06/09/2015

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

Önemli
_mbsnicoll ve _mbsnicoll_l Windows Çalışma Zamanı'nda yürütülen uygulamalarda kullanılamazlar.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

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 ile sonlandırılmış dizeler
count
Karşılaştırılacak karakter sayısı
locale
Kullanılacak yerel ayar.

Dönüş Değeri

Bu işlevlerin her biri, aşağıdaki gibi, string1 ve string2*,* alt dizelerinin ilişkisini gösteren bir değer döndürür.

Dönüş değeri	dize1'in dize2 ile ilişkisi
< 0	string1, string2 parametresinden küçüktür
0	string1string2 ile aynı
> 0	string1, string2 parametresinden büyüktür.

Bu işlevlerin her biri, _NLSCMPERROR öğesini döndürür._NLSCMPERROR kullanmak için, STRING.H veya MBSTRING.H ekleyin._wcsnicoll ya string1 ya da string2 harmanlama sırasının etki alanı dışındaki geniş karakter kodlarını içerirse başarısız olabilir.Bir hata oluştuğunda, _wcsnicoll errno 'yu EINVAL olarak ayarlayabilir._wcsnicoll çağırmasında bir hata kontrolü yapmak için, errno'yu 0 olarak ayarlayın ve ardından _wcsnicoll**.** çağırması sonrasında errno'yu kontrol edin.

Notlar

Bu işlevlerin her biri, kod sayfasına göre string1 ve string2 öğelerinin ilk count karakterlerinin büyük küçük harf duyarsız bir karşılaştırmasını yapar.Bu işlevler yalnızca, kod sayfasında karakter kümesi sırası ve lexicographic karakter sırası arasında bir fark olduğunda ve bu fark, dize karşılaştırması için anlamlı olduğunda kullanılmalıdır.Bu işlevlerin, _l soneki olmayan sürümleri, geçerli yerel ayar ve kod sayfası kullanır._l sonekine sahip sürümler, iletilmiş yerel ayarı kullanmaları dışında aynıdır.Daha fazla bilgi için bkz. Yerel Ayar.

Bu işlevlerin tümü kendi parametrelerini doğrular.string1 veya string2 null bir işaretçiyse veya sayı INT_MAX sayısından büyükse, Parametre Doğrulama konusunda açıklanan şekilde geçersiz parametre çağrılır.Yürütmenin devam etmesine izin verilirse, bu işlevler _NLSCMPERROR döndürür ve errno öğesini EINVAL olarak ayarlar**.**

Genel Metin Yordam Eşleşmeleri