Aracılığıyla paylaş

_strnicmp, _wcsnicmp, _mbsnicmp, , _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

  • Makale

Büyük/küçük harfe bakılmaksızın iki dizenin belirtilen karakter sayısını karşılaştırır.

Önemli

_mbsnicmpve _mbsnicmp_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 _strnicmp(
   const char *string1,
   const char *string2,
   size_t count
);
int _wcsnicmp(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count
);
int _mbsnicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count
);
int _strnicmp_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicmp_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsnicmp_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

Aşağıdaki gibi alt dizeler arasındaki ilişkiyi gösterir.

Dönüş değeri Açıklama
< 0 string1 alt dize, alt dizeden string2 küçüktür.
0 string1 alt dize, alt dizeyle string2 aynıdır.
> 0 string1 alt dize, alt dizeden büyüktür string2 .

Parametre doğrulama hatasında, bu işlevler string.h ve <mbstring.h>> içinde <tanımlanan değerini döndürür_NLSCMPERROR.

Açıklamalar

_strnicmp işlevi, en fazla ve string2'nin ilk count karakterlerini string1 karşılaştırır. Karşılaştırma, her karakteri küçük harfe dönüştürerek büyük/küçük harfe bakılmaksızın gerçekleştirilir. _strnicmp , büyük/küçük harfe duyarlı olmayan bir sürümüdür strncmp. Karakterler karşılaştırılamadan önce count her iki dizede de sonlandırıcı null karaktere ulaşılırsa karşılaştırma sona erer. Karakterler karşılaştırılamadan önce count bir dizede sonlandırıcı null karaktere ulaşıldığında dizeler eşitse, daha kısa dize daha az olur.

ASCII tablosundaki ('[', '\', ']', '^', '_' ve ''') 91 ile 96 arası karakterler herhangi bir alfabetik karakterden küçük olarak değerlendirilir. Bu sıralama, ile stricmpaynıdır.

_wcsnicmp ve _mbsnicmp geniş karakterli ve çok baytlı sürümleridir _strnicmp. bağımsız değişkenleri _wcsnicmp geniş karakterli dizelerdir. bağımsız değişkenleri _mbsnicmp çok baytlı karakter dizeleridir. _mbsnicmp geçerli çok baytlı kod sayfasına göre çok baytlı karakter dizilerini tanır ve bir hata döndürür _NLSCMPERROR . Daha fazla bilgi için bkz . Kod sayfaları. Bu üç işlev aynı şekilde davranır. Bu işlevler yerel ayardan etkilenir; son ekine sahip _l olmayan sürümler, yerel ayara bağımlı davranışları için geçerli yerel ayarı kullanır; bunun yerine son eki olan _l sürümler geçirileni locale kullanır. Daha fazla bilgi için bkz . Yerel Ayar.

Bu işlevlerin tümü parametrelerini doğrular. string1 Veya string2 null işaretçiyse, 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
_tcsncicmp _strnicmp _mbsnicmp _wcsnicmp
_tcsnicmp _strnicmp _mbsnbicmp _wcsnicmp
_tcsncicmp_l _strnicmp_l _mbsnicmp_l _wcsnicmp_l

Gereksinimler

Yordam Gerekli başlık
_strnicmp, _strnicmp_l <string.h>
_wcsnicmp, _wcsnicmp_l <string.h> veya <wchar.h>
_mbsnicmp, _mbsnicmp_l <mbstring.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

örneğine strncmpbakın.

Ayrıca bkz.

Dize işleme
strcat, wcscat, _mbscat
strcmp, wcscmp, _mbscmp
strcpy, wcscpy, _mbscpy
strncat, _strncat_l, wcsncat, , _wcsncat_l, _mbsncat, _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy, _strncpy_l, wcsncpy, , _wcsncpy_l, _mbsncpy, _mbsncpy_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l
_strset, _strset_l, _wcsset, , _wcsset_l, _mbsset, _mbsset_l
strspn, wcsspn, _mbsspn, _mbsspn_l