_mbsnbcmp, _mbsnbcmp_l

İki çok baytlı karakter dizesinin ilk n baytını karşılaştırır.

Önemli

Bu API, 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 _mbsnbcmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count
);
int _mbsnbcmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

Parametreler

string1, string2
Karşılaştıracak dizeler.

count
Karşılaştıracak bayt sayısı.

locale
Kullanılacak yerel ayar.

Dönüş değeri

Dönüş değeri ve string2alt dizeleri arasındaki sıralı ilişkiyi string1 gösterir.

Dönüş değeri	Tanım
< 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 _mbsnbcmp ve dize.h ve _mbsnbcmp_l<mbstring.h>> içinde <tanımlanan değerini döndürür_NLSCMPERROR.

Açıklamalar

_mbsnbcmp İşlevler ve içindeki string1string2 en çok ilk count baytları karşılaştırır ve alt dizeler arasındaki ilişkiyi gösteren bir değer döndürür. _mbsnbcmp , büyük/küçük harfe duyarlı bir sürümüdür _mbsnbicmp. _mbsnbcmp'nin aksine_mbsnbcoll, yerel ayarın harmanlama düzeninden etkilenmez. _mbsnbcmpgeçerli çok baytlı kod sayfasına göre çok baytlı karakter dizilerini tanır.

_mbsnbcmp benzer, _mbsncmpancak _mbsncmp dizeleri bayt yerine karakterlere göre karşılaştırır.

Çıkış değeri, çok baytlı karakterlerin LC_CTYPE başlangıç baytlarını ve sondaki baytları belirten yerel ayarın kategori ayarından etkilenir. Daha fazla bilgi için bkz. setlocale. İşlev, _mbsnbcmp bu yerel ayara bağımlı davranış için geçerli yerel ayarı kullanır. _mbsnbcmp_l işlevi, parametresini kullanması locale dışında aynıdır. Daha fazla bilgi için bkz . Yerel Ayar.

string1 veya string2 null işaretçiyse, bu işlevler Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisini çağırır. Yürütmenin devam etmesi için izin verilirse, işlevler döndürür _NLSCMPERRORve errno olarak EINVALayarlanır.

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
_tcsncmp	strncmp	_mbsnbcmp	wcsncmp
_tcsncmp_l	strncmp	_mbsnbcml	wcsncmp

Gereksinimler

Yordam	Gerekli başlık
_mbsnbcmp	<mbstring.h>
_mbsnbcmp_l	<mbstring.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

// crt_mbsnbcmp.c
#include <mbstring.h>
#include <stdio.h>

char string1[] = "The quick brown dog jumps over the lazy fox";
char string2[] = "The QUICK brown fox jumps over the lazy dog";

int main( void )
{
   char tmp[20];
   int result;
   printf( "Compare strings:\n          %s\n", string1 );
   printf( "          %s\n\n", string2 );
   printf( "Function: _mbsnbcmp (first 10 characters only)\n" );
   result = _mbsncmp( string1, string2 , 10 );
   if( result > 0 )
      _mbscpy_s( tmp, sizeof(tmp), "greater than" );
   else if( result < 0 )
      _mbscpy_s( tmp, sizeof(tmp), "less than" );
   else
      _mbscpy_s( tmp, sizeof(tmp), "equal to" );
   printf( "Result:   String 1 is %s string 2\n\n", tmp );
   printf( "Function: _mbsnicmp _mbsnicmp (first 10 characters only)\n" );
   result = _mbsnicmp( string1, string2, 10 );
   if( result > 0 )
      _mbscpy_s( tmp, sizeof(tmp), "greater than" );
   else if( result < 0 )
      _mbscpy_s( tmp, sizeof(tmp), "less than" );
   else
      _mbscpy_s( tmp, sizeof(tmp), "equal to" );
   printf( "Result:   String 1 is %s string 2\n\n", tmp );
}

Çıktı

Compare strings:
          The quick brown dog jumps over the lazy fox
          The QUICK brown fox jumps over the lazy dog

Function: _mbsnbcmp (first 10 characters only)
Result:   String 1 is greater than string 2

Function: _mbsnicmp _mbsnicmp (first 10 characters only)
Result:   String 1 is equal to string 2

Ayrıca bkz.

Dize işleme
_mbsnbcat, _mbsnbcat_l
_mbsnbicmp, _mbsnbicmp_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
Yerel ayar
Çok baytlı karakter dizilerinin yorumlanması