strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l

Makale
03/26/2013

Geçerli yerel ayarı veya belirtilen lc_ctype dönüştürme durumu kategori kullanarak dizeleri karşılaştırmak.

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

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 boşlukla sonlandırılmış dizeler.
locale
Kullanılacak yerel ayarı.

Dönüş Değeri

Bu işlevlerden her biri olan ilişkisini gösteren bir değeri döndürür string1 için string2*,* gibi.

Dönüş değeri	Dize1 Dize2 için arasındaki ilişki
< 0	string1küçüktürstring2
0	string1aynıstring2
> 0	string1büyüktürstring2

Bunların her biri döndürür işlevleri _NLSCMPERROR bir hata.Kullanmak için _NLSCMPERROR, ya da dize içerir.H veya MBSTRING.H.wcscollya da, başarısız string1 veya string2 null veya harmanlama sırası, etki alanı dışındaki geniş karakter kodlarını içerir.Bir hata oluştuğunda, wcscoll kurabileceği errno için EINVAL.Yapılan çağrı sırasında hata olup olmadığını denetlemek için wcscoll, set errno 0 ve errno sonra arama wcscoll.

Notlar

Bu işlevlerden her biri, büyük küçük harfe duyarlı bir karşılaştırma yapar string1 ve string2 göre kod sayfası şu anda kullanımda.Bu işlevler yalnızca olduğunda karakter arasında bir fark sipariş ve lexicographic karakter sırasını geçerli kod sayfasını ayarlamak ve bu farkın dize karşılaştırma için ilgilendirir kullanılmalıdır.

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.

Her yerel ayar karakter sıralama farklı kuralları olduğundan, iki dize karşılaştırma yerel ayara bağımlı bir işlemdir.Bu işlevler sürümlerini _l soneki kullanan yerel ayar geçerli iş parçacığının bu yerel ayara bağımlı davranışı; sürümleri ile _l sonek dışında geçerli yerel ayarı yerine bir parametre olarak geçirilen yerel kullandıkları soneki olmayan karşılık gelen işlev ile aynı.Daha fazla bilgi için bkz. Yerel ayar.

Genel metin eşlemeleri yordamına girildi