_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 string2
alt dizeleri arasındaki sıralı ilişkiyi string1
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 _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 string1
string2
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. _mbsnbcmp
geçerli çok baytlı kod sayfasına göre çok baytlı karakter dizilerini tanır.
_mbsnbcmp
benzer, _mbsncmp
ancak _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 _NLSCMPERROR
ve errno
olarak EINVAL
ayarlanı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ı