_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

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

Önemli

_mbsicollve _mbsicoll_l Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.

Sözdizimi

int _stricoll(
   const char *string1,
   const char *string2
);
int _wcsicoll(
   const wchar_t *string1,
   const wchar_t *string2
);
int _mbsicoll(
   const unsigned char *string1,
   const unsigned char *string2
);
int _stricoll_l(
   const char *string1,
   const char *string2,
   _locale_t locale
);
int _wcsicoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   _locale_t locale
);
int _mbsicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   _locale_t locale
);

Parametreler

string1, string2
Karşılaştırmak için null olarak sonlandırılan dizeler.

locale
Kullanılacak yerel ayar.

Dönüş değeri

Bu işlevlerin her biri, ile ilişkisini string1string2gösteren bir değer döndürür.

Dönüş değeri	string1 ile ilişkisistring2
< 0	string1 küçüktür string2
0	string1 özdeş string2
> 0	string1 büyüktür string2
_NLSCMPERROR	Bir hata oluşmuştur.

Bu işlevlerin her biri döndürür _NLSCMPERROR. kullanmak _NLSCMPERRORiçin string.h> veya <mbstring.h> ekleyin<. _wcsicoll veya harmanlama dizisinin etki alanı dışında geniş karakter kodları içeriyorsa başarısız string1string2 olabilir. Bir hata oluştuğunda olarak _wcsicoll ayarlanabilir errnoEINVAL. çağrısında _wcsicollhata olup olmadığını denetlemek için 0 olarak ayarlayın errno ve çağrısı _wcsicollyaptıktan sonra denetleyinerrno.

Açıklamalar

Bu işlevlerin her biri, şu anda kullanımda olan kod sayfasına göre ve string2 büyük/küçük harfe duyarlı olmayan bir karşılaştırma string1 gerçekleştirir. Bu işlevler yalnızca geçerli kod sayfasındaki karakter kümesi sırası ile sözcüksel karakter sırası arasında bir fark olduğunda ve bu fark dize karşılaştırması için ilgi çekici olduğunda kullanılmalıdır.

_stricmp_stricoll, karşılaştırmanın _stricmp tarafından LC_CTYPEetkilendiği durumdan _stricoll farklıdır, ancak karşılaştırma yerel ayarın LC_CTYPE ve LC_COLLATE kategorilerine göredir. Kategori hakkında LC_COLLATE daha fazla bilgi için bkz setlocale . ve Yerel ayar kategorileri. Bu işlevlerin son eki olmayan _l sürümleri geçerli yerel ayarı kullanır; sonekli _l sürümler, bunun yerine geçirilen yerel ayarı kullanmaları dışında aynıdır. Daha fazla bilgi için bkz . Yerel Ayar.

Bu işlevlerin tümü parametrelerini doğrular. İşaretçilerden biri string1 veya işaretçileri NULL varsa, parametre doğrulamasında açıklandığı gibi geçersiz parametre işleyicisi string2 çağrılır. Yürütmenin devam etmesi için izin verilirse, bu işlevler döndürülerek _NLSCMPERROR olarak EINVALayarlanırerrno.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

TCHAR.H yordamı	_UNICODE ve _MBCS tanımlanmadı	_MBCS Tanımlanan	_UNICODE Tanımlanan
_tcsicoll	_stricoll	_mbsicoll	_wcsicoll

Gereksinimler

Yordam	Gerekli başlık
_stricoll, _stricoll_l	<string.h>
_wcsicoll, _wcsicoll_l	<wchar.h>, <string.h>
_mbsicoll, _mbsicoll_l	<mbstring.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Ayrıca bkz.

Yerel ayar
Dize işleme
strcoll işlevleri
localeconv
_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l
setlocale, _wsetlocale
strcmp, wcscmp, _mbscmp
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l