_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

Makale
03/27/2013

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

Önemli
_mbsncollve _mbsncoll_l yürütün uygulamalarda kullanılamaz Windows Çalışma Zamanı.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

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 boşlukla 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 accessible arasındaki ilişkiyi gösteren bir değeri döndürür string1 ve string2gibi.

Dönüş değeri	Dize1 Dize2 için arasındaki ilişki
< 0	string1olduğundan az string2.
0	string1aynıdır string2.
> 0	string1büyük string2.

Bunların her biri döndürür işlevleri _NLSCMPERROR.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, _wcsncoll kurabileceği errno için EINVAL.Yapılan çağrı sırasında hata olup olmadığını denetlemek için _wcsncoll, set 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 karakterler string1 ve string2, şu anda kullanımda olan kod sayfası göre.Bu işlevler kod sayfası karakter kümesi sırası lexicographic karakter sırası arasındaki fark olduğunda ve 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.Sürümleri yüklü değilse bu işlevlerin _l sonekini kullan geçerli yerel ayarı, ancak olan sürümleri _l sonek geçirilen yerel ayarı kullanın.Daha fazla bilgi için bkz. Yerel ayar.

Tüm bu işlevleri kendi parametrelerini doğrulayın.Ya da, string1 veya string2 bir null işaretçi veya count büyük INT_MAX, açıklandığı gibi geçersiz bir parametre işleyici çağrılır Parametre doğrulama.Yürütülmesine devam etmek için izin verilip verilmediğini, bu işlevler dönmek _NLSCMPERROR ve errno için EINVAL.

Genel metin eşlemeleri yordamına girildi