_mbsnbcmp, _mbsnbcmp_l

Сравнивает первые n байты двух многобайтовых строк.

Важно!

Этот API нельзя использовать в приложениях, выполняемых в среде выполнения Windows. Дополнительные сведения: Функции CRT, которые не поддерживаются в приложениях универсальной платформы Windows.

Синтаксис

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
);

Параметры

string1, string2
Строки для сравнения.

count
Число байтов для сравнения.

locale
Используемый языковой стандарт.

Возвращаемое значение

Возвращаемое значение отражает порядковую взаимосвязь подстрок string1 и string2.

Возвращаемое значение	Description
< 0	Подстрока string1 меньше, чем подстрока string2.
0	Подстрока string1 идентична подстроке string2.
> 0	Подстрока string1 больше, чем подстрока string2.

При ошибке _mbsnbcmp проверки параметров и _mbsnbcmp_l возврате _NLSCMPERROR, который определен в <string.h> и <mbstring.h>.

Замечания

Функции _mbsnbcmp сравнивают не более чем count первых байт в string1 и string2 и возвращают значение, указывающее отношение между подстроками. _mbsnbcmp — чувствительная к регистру версия _mbsnbicmp. В отличие _mbsnbcollот этого, _mbsnbcmp не влияет порядок сортировки языкового стандарта. Функция _mbsnbcmp распознает последовательности многобайтовых символов в соответствии с текущей многобайтовой кодовой страницей.

Функция _mbsnbcmp похожа на _mbsncmp за тем исключением, что _mbsncmp сравнивает строки посимвольно, а не побайтно.

На выходное значение влияет настройка категории LC_CTYPE языкового стандарта, которая определяет начальные и конечные байты многобайтовых символов. Дополнительные сведения см. в разделе setlocale. Функция _mbsnbcmp использует текущий языковой стандарт для данной функциональности, зависящей от языкового стандарта. Функция _mbsnbcmp_l идентична за исключением того, что она использует вместо этого параметр locale. Дополнительные сведения см. в разделе Locale.

Если указатель string1string2 имеет значение NULL, эти функции вызывают обработчик недопустимых параметров, как описано в разделе проверки параметров. Если выполнение разрешено продолжать, функция возвращается _NLSCMPERRORи errno имеет значение EINVAL.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Подпрограмма Tchar.h	_UNICODE и _MBCS не определен	_MBCS Определенные	_UNICODE Определенные
_tcsncmp	strncmp	_mbsnbcmp	wcsncmp
_tcsncmp_l	strncmp	_mbsnbcml	wcsncmp

Требования

Маршрут	Обязательный заголовок
_mbsnbcmp	<mbstring.h>
_mbsnbcmp_l	<mbstring.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

// 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 );
}

Выходные данные

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

См. также

Обработка строк
_mbsnbcat, _mbsnbcat_l
_mbsnbicmp, _mbsnbicmp_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
Локаль
Интерпретация последовательностей многобайтовых символов