Aracılığıyla paylaş


_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

İki dizeleri büyük/küçük harf bağımsız karakter karşılaştırır.

Önemli notÖnemli

_mbsnicmpve _mbsnicmp_l yürütün uygulamalarda kullanılamaz Windows Çalışma Zamanı.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

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 boşlukla sonlandırılmış dizeler.

  • count
    Karşılaştırmak için karakter sayısı.

  • locale
    Kullanılacak yerel ayarı.

Dönüş Değeri

Gibi alt dizeleri arasındaki ilişkiyi gösterir.

Dönüş değeri

Tanımlama

< 0

string1alt dize olduğundan az string2 alt dize.

0

string1alt dize aynı string2 alt dize.

> 0

string1alt dize büyük string2 alt dize.

Bir hata _mbsnicmp fonksiyonu _NLSCMPERROR, dize içinde tanımlanmış.H ve MBSTRING.H.

Notlar

_strnicmp İşlevi lexicographically karşılaştırır, en çok, ilk count karakter string1 ve string2.Büyük/küçük harf bir karşılaştırma gerçekleştirilir; _strnicmpbüyük küçük harf duyarsız bir sürümüdür strncmp.Sondaki boş karakter ya da dize önce ulaşılırsa karşılaştırma sona count karakter karşılaştırılır.Dizeleri eşit olması durumunda, sondaki boş karakter ulaşıldığında önce ya da dize count daha kısa bir dize daha düşük olduğundan, karakter karşılaştırılır.

ASCII tablosundaki 96 91 karakterleri ('[', ' \', ']', ' ^', '_' ve ''') olarak küçüktür herhangi bir alfabetik karakter değerlendirmek.Bu sıralama olarak aynı stricmp.

_wcsnicmpve _mbsnicmp geniş karakter ve çok baytlı karakter sürümleri _strnicmp.Bağımsız değişkenleri ve dönüş değeri _wcsnicmp geniş karakter dizesidir; _mbsnicmp çok baytlı karakter dizeleridir._mbsnicmpGeçerli çok baytlı kod sayfasını göre çok baytlı karakter dizilerini tanır ve döner _NLSCMPERROR bir hata.Daha fazla bilgi için bkz. Kod sayfaları.Bu üç işlevi aynı şekilde aksi davranır.Bu işlevler, yerel ayara göre etkilenir — olmayan sürümleri _l soneki kullanan geçerli yerel ayarı, yerel ayarlara bağımlı davranışlarını; olan sürümleri _l sonek geçirilen yerel ayarı kullanın.Daha fazla bilgi için bkz. Yerel ayar.

Tüm bu işlevleri kendi parametrelerini doğrulayın.Ya da, string1 veya string2 bir null işaretçi 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.

Genel metin eşlemeleri yordamına girildi

TCHAR.H yordamına girildi

_UNICODE & _mbcs tanımlanmamış

Tanımlanan _mbcs

Tanımlanan _UNICODE

_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>

Ek uyumluluk bilgileri için bkz: Uyumluluk.

Örnek

Örnek için bkz: strncmp.

.NET Framework Eşdeğeri

System::string::COMPARE

Ayrıca bkz.

Başvuru

Dize işlemleri (crt)

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