_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l

Makale
06/09/2015

Çok baytlı kod sayfası bilgilerini kullanarak n iki çok baytlı karakter dizesini karşılaştırır.

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

int _mbsnbcoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _mbsnbcoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);
int _mbsnbicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _mbsnbicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

Parametreler

string1, string2
Karşılaştırılacak dizeler.
count
Karşılaştırılacak bayt sayısı.
locale
Kullanılacak yerel ayar.

Dönüş Değeri

Dönüş değeri string1 ve string2 alt dizelerinin ilgisini belirtir.

Dönüş değeri	Tanımlama
< 0	string1 alt dizesi string2 alt dizesinden küçük.
0	string1 alt dizesi string2 alt dizesiyle aynı.
> 0	string1 alt dizesi string2 alt dizesinden daha büyük.

string1 veya string2 öğesi NULL ise ya da countINT_MAX değerinden büyükse, Parametre Doğrulama içinde açıklandığı şekilde geçersiz parametre işleyicisi ç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._NLSCMPERROR kullanmak için, String.h veya Mbstring.h ekleyin.

Notlar

Bu işlevlerin her biri, en fazla ilk count baytı string1 ve string2 içinde harmanlar ve sonuçta elde edilen string1 ve string2 alt dizeleri arasındaki ilişkiyi gösteren bir değeri döndürür.string1 veya string2 alt dizesindeki son bayt bir ön baytsa karşılaştırmaya eklenmez; bu işlevler yalnızca alt dizelerdeki tam karakterleri karşılaştırır._mbsnbicoll_mbsnbcollöğesinin büyük/küçük harfe duyarlı bir sürümüdür._mbsnbcmp ve _mbsnbicmp gibi, _mbsnbcoll ve _mbsnbicoll öğeleri de iki çok baytlı karakter dizelerini, şu anda kullanımda olan çok baytlı kod sayfası tarafından belirtilen sözlük sırasına göre derler.

Bazı kod sayfaları ve ilgili karakter kümeleri için, karakter kümesindeki karakterlerin sırası sözlük karakter sırasından farklı olabilir."C" yerel ayarında böyle olmaz: ASCII karakter kümesindeki karakter sırası karakterlerin sözlük sıralamasıyla aynıdır.Ancak, belirli Avrupa kod sayfalarında, örneğin, 'a' karakteri (değer 0x61) karakter kümesinde 'ä' karakterinden önce gelir, ancak 'ä' karakteri sözlüksel olarak 'a' karakterinden önce gelir.Dizelerin, böyle bir örnekte lexicographic karşılaştırmasını gerçekleştirmek için, _mbsnbcmp yerine _mbsnbcoll kullanın ya da dize eşitliği kontrolü yapmak için, _mbsnbcmp kullanın.

cmp işlevleri yalnızca dize eşitliğini test ederken, coll işlevleri ise dizeleri karşılaştırma için sözlüksel olarak harmanladığı için, coll işlevleri ilgili cmp sürümlerine göre daha yavaştır.Bu nedenle, coll işlevleri yalnızca, mevcut kod sayfasında karakter kümesi sırası ve lexicographic karakter sırası arasında bir fark olduğunda ve bu farkın, karşılaştırma için anlamlı olduğunda kullanılmalıdır.

Çıkış değeri, yerel ayarın LC_CTYPE kategori ayarından etkilenir; daha fazla bilgi için, bkz. setlocale.Bu işlevlerin, _l sonekine sahip olmayan sürümleri, yerel ayara bağlı davranışı için, geçerli yerel ayarı kullanır; _l sonekine sahip sürümler, bunun yerine iletilmiş yerel ayar parametresini kullanması hariç aynıdır.Daha fazla bilgi için bkz. Yerel Ayar.

Genel Metin Yordam Eşleşmeleri

Tchar.h yordamı	_UNICODE ve _MBCS tanımlanmaz	_MBCS tanımlanmış	_UNICODE tanımlanmış
_tcsncoll	_strncoll	_mbsnbcoll	_wcsncoll
_tcsncoll_l	_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l	_mbsnbcoll_l	_wcsncoll_l
_tcsnicoll	_strnicoll	_mbsnbicoll	_wcsnicoll
_tcsnicoll_l	_strnicoll_l	_mbsnbicoll_l	_wcsnicoll_l