_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l

Makale
03/27/2013

Karşılaştırır n bayt iki çok baytlı karakter dizeleri kullanılarak çok baytlı kod sayfası bilgileri.

Önemli
Bu API, Windows çalışma zamanı yürütme uygulamalarda kullanılamaz.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

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
Dizeleri karşılaştırmak için.
count
Karşılaştırmak için bayt sayısı.
locale
Kullanılacak yerel ayarı.

Dönüş Değeri

Dönüş değeri accessible ilişkiyi gösterir string1 ve string2.

Dönüş değeri	Tanımlama
< 0	string1alt dize değerinden string2 alt dize.
0	string1alt dize aynı string2 alt dize.
> 0	string1alt dize büyük string2 alt dize.

string1 Veya string2 olan NULL 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.Kullanmak için _NLSCMPERROR, String.h veya Mbstring.h içerir.

Notlar

Bu işlevlerden her biri, en çok, ilk harmanlar count bayt cinsinden string1 ve string2 ve sonuçta elde edilen accessible arasındaki ilişkiyi gösteren bir değeri döndürür string1 ve string2.Son baytın alt string1 veya string2 bir ön bayt olup karşılaştırma; bulunmaz Bu işlevler yalnızca tam karakter alt dizeleri karşılaştırmak._mbsnbicollbüyük küçük harf duyarsız bir sürümüdür _mbsnbcoll.Gibi _mbsnbcmp ve _mbsnbicmp, _mbsnbcoll ve _mbsnbicoll lexicographic çok baytlı tarafından belirtilen sıraya göre iki çok baytlı karakter dizeleri harmanlanıp kod sayfası şu anda kullanımda.

Bazı kod sayfaları ve karşılık gelen karakter kümeleri için karakter kümesindeki karakterlerin sırasını lexicographic karakter siparişten farklılık gösterebilir."c" yerel ayarını durum bu değildir: ASCII karakter kümesinde karakter sırasını lexicographic karakter sırası ile aynıdır.Ancak, bazı Avrupa kod sayfaları, örneğin, karakter 'a' (değer 0x61) 'ä' (0xE4) karakter değerini, karakter karakter önündeki 'ä' önündeki karakteri 'a' lexicographically.Bayt cinsinden bir örneği tarafından lexicographic bir karşılaştırma dizisini gerçekleştirmek için kullanın _mbsnbcoll yerine _mbsnbcmp; yalnızca dize eşitlik için denetlemek için _mbsnbcmp.

Çünkü coll oysa işlevler harmanlama dize karşılaştırma, lexicographically için cmp işlevler yalnızca dize eşitlik için test coll işlevleri ilgili daha çok daha yavaş cmp sürümleri.Bu nedenle, coll işlevler yalnızca geçerli kod sayfası karakter kümesi sırası ve lexicographic karakter sırası arasında fark yoktur ve bu fark karşılaştırma için ilgi olduğunda kullanılmalıdır.

Çıkış değeri ayarı tarafından etkilenen LC_CTYPE ; bölgesel ayar kategorisi bkz: setlocale daha fazla bilgi için.Bu işlevler sürümlerini _l soneki kullanan geçerli yerel ayarı için bu yerel ayara bağımlı davranışı; sürümleri ile _l sonek dışında bunun yerine geçirilen yerel ayar parametresi kullandıkları aynı.Daha fazla bilgi için bkz. Yerel ayar.

Genel metin eşlemeleri yordamına girildi

Tchar.h yordamına girildi	_UNICODE ve _mbcs tanımlanmamış	Tanımlanan _mbcs	Tanımlanan _UNICODE
_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