_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l
Yerel ayara özgü bilgileri kullanarak dizeleri karşılaştırır.
![]() |
---|
_mbsnicoll ve _mbsnicoll_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 _strnicoll(
const char *string1,
const char *string2,
size_t count
);
int _wcsnicoll(
const wchar_t *string1,
const wchar_t *string2 ,
size_t count
);
int _mbsnicoll(
const unsigned char *string1,
const unsigned char *string2,
size_t count
);
int _strnicoll_l(
const char *string1,
const char *string2,
size_t count,
_locale_t locale
);
int _wcsnicoll_l(
const wchar_t *string1,
const wchar_t *string2 ,
size_t count,
_locale_t locale
);
int _mbsnicoll_l(
const unsigned char *string1,
const unsigned char *string2,
size_t count,
_locale_t locale
);
Parametreler
string1, string2
Karşılaştırmak için null ile sonlandırılmış dizelercount
Karşılaştırılacak karakter sayısılocale
Kullanılacak yerel ayar.
Dönüş Değeri
Bu işlevlerin her biri, aşağıdaki gibi, string1 ve string2*,* alt dizelerinin ilişkisini 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, _NLSCMPERROR öğesini döndürür._NLSCMPERROR kullanmak için, STRING.H veya MBSTRING.H ekleyin._wcsnicoll ya string1 ya da string2 harmanlama sırasının etki alanı dışındaki geniş karakter kodlarını içerirse başarısız olabilir.Bir hata oluştuğunda, _wcsnicoll errno 'yu EINVAL olarak ayarlayabilir._wcsnicoll çağırmasında bir hata kontrolü yapmak için, errno'yu 0 olarak ayarlayın ve ardından _wcsnicoll**.** çağırması sonrasında errno'yu kontrol edin.
Notlar
Bu işlevlerin her biri, kod sayfasına göre string1 ve string2 öğelerinin ilk count karakterlerinin büyük küçük harf duyarsız bir karşılaştırmasını yapar.Bu işlevler yalnızca, 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, _l soneki olmayan sürümleri, geçerli yerel ayar ve kod sayfası kullanır._l sonekine sahip sürümler, iletilmiş yerel ayarı kullanmaları dışında aynıdır.Daha fazla bilgi için bkz. Yerel Ayar.
Bu işlevlerin tümü kendi parametrelerini doğrular.string1 veya string2 null bir işaretçiyse veya sayı INT_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**.**
Genel Metin Yordam Eşleşmeleri
TCHAR.H yordamı |
_UNICODE & _MBCS tanımlanmamış |
_MBCS tanımlanmış |
_UNICODE tanımlanmış |
---|---|---|---|
_tcsncicoll |
_strnicoll |
_mbsnbicoll |
_wcsnicoll |
_tcsnicoll |
_strnicoll |
_wcsnicoll |
|
_tcsnicoll_l |
_strnicoll_l |
_mbsnbicoll_l |
_wcsnicoll_l |
Gereksinimler
Yordam |
Gerekli başlık |
---|---|
_strnicoll, _strnicoll_l |
<string.h> |
_wcsnicoll, _wcsnicoll_l |
<wchar.h> veya <string.h> |
_mbsnicoll, _mbsnicoll_l |
<mbstring.h> |
Ek uyumluluk bilgileri için bkz. Uyumluluk.
.NET Framework Eşdeğeri
Ayrıca bkz.
Başvuru
_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l