_strnicoll, _wcsnicoll, _mbsnicoll, , _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

  • Makale

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

Önemli

_mbsnicollve _mbsnicoll_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 _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 olarak sonlandırılan dizeler

count
Karşılaştıracak karakter sayısı

locale
Kullanılacak yerel ayar.

Dönüş değeri

Bu işlevlerin her biri aşağıdaki gibi ve string2alt dizelerinin string1 ilişkisini gösteren bir değer döndürür.

Dönüş değeri Dize1 ile dize2 ilişkisi
< 0 string1 küçüktür string2
0 string1 özdeş string2
> 0 string1 büyüktür string2

Bu işlevlerin her biri döndürür _NLSCMPERROR. kullanmak _NLSCMPERRORiçin DIZE'yi ekleyin. H veya MBSTRING.H. _wcsnicoll veya harmanlama dizisinin etki alanı dışında geniş karakter kodları içeriyorsa başarısız string1 string2 olabilir. Bir hata oluştuğunda olarak _wcsnicoll ayarlanabilir errno EINVAL. çağrısında _wcsnicollhata olup olmadığını denetlemek için 0 olarak ayarlayın errno ve çağrısı _wcsnicollyaptıktan sonra denetleyinerrno.

Açıklamalar

Bu işlevlerin her biri, içindeki ve string2 kod sayfasına göre ilk count karakterlerin string1 büyük/küçük harfe duyarsız bir karşılaştırmasını gerçekleştirir. Bu işlevler yalnızca kod sayfasındaki karakter kümesi sırası ile sözcüksel karakter sırası arasında bir fark olduğunda kullanılmalıdır ve bu fark dize karşılaştırması için önemlidir. Bu işlevlerin son eki olmayan _l sürümleri geçerli yerel ayarı ve kod sayfasını kullanır. Son eki olan _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. string1 string2 veya null işaretçiyse veya sayı değerinden INT_MAXbüyükse, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi ç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
_tcsncicoll _strnicoll _mbsnbicoll _wcsnicoll
_tcsnicoll _strnicoll _mbsnbicoll _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>

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