strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l

Makale
06/09/2015

Geçerli yerel ayarı veya belirtilen LC_COLLATE dönüştürme durumu kategori kullanılarak dizesini karşılaştırır.

Önemli
_mbscoll ve _mbscoll_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 strcoll(
   const char *string1,
   const char *string2 
);
int wcscoll(
   const wchar_t *string1,
   const wchar_t *string2 
);
int _mbscoll(
   const unsigned char *string1,
   const unsigned char *string2 
);
int _strcoll_l(
   const char *string1,
   const char *string2,
   _locale_t locale 
);
int wcscoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   _locale_t locale 
);
int _mbscoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   _locale_t locale 
);

Parametreler

string1, string2
Karşılaştırmak için null ile sonlandırılmış dizeler.
locale
Kullanılacak yerel ayar.

Dönüş Değeri

Bu işlevlerin her biri, aşağıdaki gibi, string1 ile string2*,* arasındaki ilişkiyi 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, bir hatada _NLSCMPERROR öğesini döndürür._NLSCMPERROR kullanmak için, STRING.H veya MBSTRING.H ekleyin.string1 ya da string2 BOŞ ise veya harmanlama sırasının etki alanı dışındaki geniş karakter kodlarını içerirse wcscoll başarısız olabilir.Bir hata oluştuğunda, wcscoll errno 'yu EINVAL olarak ayarlayabilir.wcscoll çağırmasında bir hata kontrolü yapmak için errno'ı 0 olarak ayarlayın ve ardından wcscoll çağırması sonrasında errno'yu kontrol edin.

Notlar

Bu işlevlerin her biri, şu anda kullanılan kod sayfasına göre string1 ve string2 öğelerinin büyük küçük harf duyarlı bir karşılaştırmasını yapar.Bu işlevler 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, dize karşılaştırması için anlamlı olduğunda kullanılmalıdır.

Bu işlevlerin tümü kendi parametrelerini doğrular.string1 veya string2 null bir işaretçiyse veya countINT_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.

İki dizenin karşılaştırılması, her yerel ayarın karakterleri sıralamak için farklı kuralları olduğundan yerel ayara bağlı bir işlemdir.Bu işlevlerin, _l sonekine sahip olmayan sürümleri, bu yerel ayar davranışı için geçerli iş parçacığı yerel ayarını kullanır; _l sonekine sahip sürümleri, parametre olarak, geçerli yerel ayar yerine iletilmiş yerel ayarı kullanmaları hariç, soneke sahip olmayan ilgili işlevle aynıdır.Daha fazla bilgi için bkz. Yerel Ayar.

Genel Metin Yordam Eşleşmeleri