_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Статья
04/10/2013

Сравнивает символы 2 строк вне зависимости от варианта.

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

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

Параметры

string1, string2
Строки с завершающим нулем для сравнения.
count
Число символов для сравнения.
locale
Языковой стандарт, который необходимо использовать.

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

Отображает связь между подстроками следующим образом.

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

При ошибке _mbsnicmp возвращает _NLSCMPERROR, которая определена в STRING.H и MBSTRING.H.

Заметки

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

Символы от 91 до 96 в таблице ASCII (" [", "\", "]", "^", "_" и "'") сначала, чем любой символ.Этот порядок идентично в одно из stricmp.

_wcsnicmp и _mbsnicmp — двубайтовая и многобайтовая символьные версии _strnicmp.Аргументы и возвращаемое значение _wcsnicmp являются строками из двубайтовых символов; они же в _mbsnicmp являются строками с многобайтовых символов._mbsnicmp распознает последовательности многобайтовых символов в соответствии с текущей многобайтовой кодовой страницей и возвращает _NLSCMPERROR при ошибке.Для получения дополнительной информации см. Кодовые страницы.В остальных случаях эти три функции ведут себя идентично.Эти функции затронутых версиями параметра - языкового стандарта, не имеющие помощью суффикса _l текущий языковой стандарт для них расширения функциональности языкового стандарта, элемента. версии, которые имеют суффикс _l вместо использования языковой стандарт, который передается в.Для получения дополнительной информации см. Языковой стандарт.

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

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