_mbsnbicmp, _mbsnbicmp_l

  • Статья

Сравнивает байты n 2 строк многобайтовой кодировки, без учета регистра.

Важное примечаниеВажно

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

 
int _mbsnbicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);

Параметры

  • string1, string2
    Строки с завершающим нулем для сравнения.

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

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

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

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

Описание

< 0

подстрока подстрока string1, чем string2.

0

подстрока идентичная подстроке string1 в string2.

> 0

подстрока string1 более крупные подстрока, чем string2.

При возникновении ошибки _mbsnbcmp возвращает _NLSCMPERROR, которая определена в String.h и Mbstring.h.

Заметки

Функция _mbsnbicmp лексикографически сравнивает, по крайней мере, первый байт countstring1 и string2.Сравнение выполняется вне зависимости от обращения; _mbsnbcmp учитывается регистр версия _mbsnbicmp.Если выполнить сравнение конечное нуль-символ достигается в любой строке, прежде чем символы count сравниваются.Если строки равно при последующей нуль-символ достигается в любой строке перед символы count сравнения, более короткая строка на.

_mbsnbicmp аналогично _mbsnicmp, за исключением того, что она сравнивает строки байтов вместо символов.

2 Строки, содержащие символы расположены между "Z" и "a" в таблице " [ASCII (", "\", "]", "^", "_" и "'") " по-разному, в зависимости от их варианта.Например, строку "2" и "ABCDE"ABCD^", если один способ сравнения в нижнем регистре ("abcde" > "abcd^") и другие способы, ("ABCDE" < "ABCD^"), если оно прописными буквами.

_mbsnbicmp распознает последовательности многобайтовой кодировки в соответствии с многобайтовой кодовой страницы в использовании.Он не влияет на текущим параметром языкового стандарта.

Если string1 или string2, то указатель _mbsnbicmp вызывает обработчик недопустимого параметра, как описано в разделе Проверка параметров.Если среда выполнения может продолжить, функция _NLSCMPERROR возвращает и задает для errno значение EINVAL.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H

Не указаны _UNICODE и _MBCS

определенные _MBCS

Определение _UNICODE

_tcsnicmp

_strnicmp

_mbsnbicmp

_wcsnicmp

_tcsnicmp_l

_strnicmp_l

_mbsnbicmp_l

_wcsnicmp_l

Требования

Функция

Требуемый заголовок

_mbsnbicmp

<mbstring.h>

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

Пример

См. пример в разделе _mbsnbcmp, _mbsnbcmp_l.

Эквивалент в .NET Framework

Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.

См. также

Ссылки

Управление строками (CRT)

_mbsnbcat, _mbsnbcat_l

_mbsnbcmp, _mbsnbcmp_l

_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l