_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

Makale
06/09/2015

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

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

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

Dönüş Değeri

Bu işlevlerden her biri bu nedenle arasındaki ilişkiyi gösteren bir değeri döndürür string1 ve string2, aşağıdaki gibi.

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

Bu işlevlerin her biri, _NLSCMPERROR öğesini döndürür.Kullanmak için _NLSCMPERROR, STRING.h veya MBSTRING.h içerir._wcsncollya da, başarısız string1 veya string2 harmanlama sırası etki alanı dışında olan geniş karakter kodlarını içerir.Bir hata oluştuğunda, _wcsncollerrno'yu EINVAL olarak ayarlayabilir.Yapılan çağrı sırasında hata denetlemek için _wcsncoll, belirlenen errno 0 ve errno ardından _wcsncoll.

Notlar

Bu işlevlerden her biri ilk büyük küçük harfe duyarlı bir karşılaştırma yapar count alanına string1 ve string2, şu anda kullanımda olan kod sayfası göre.Bu işlevler yalnızca kod sayfası karakter kümesi sırası ve lexicographic karakter sırası arasında fark olduğunda, bu farkın dize karşılaştırma için ilgi olduğunda kullanın.Karakter kümesi yerel ayara bağımlı sırasıdır.Yoksa bu işlevlerin sürümleri _l sonek kullanımı geçerli yerel ayarı, ancak olan sürümleri _l son geçirilen yerel ayar kullan.Daha fazla bilgi için bkz. Yerel Ayar.

Bu işlevlerin tümü kendi parametrelerini doğrular.Ya da, string1 veya string2 bir null işaretçi veya count daha büyük INT_MAX, açıklandığı gibi geçersiz bir parametre işleyicisi çağrılır Parametre Doğrulama.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