_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
Сравнивает символы 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.
Универсальное текстовое сопоставление функций
Функция TCHAR.H |
неопределенные _UNICODE & _MBCS |
определенные _MBCS |
Определение _UNICODE |
---|---|---|---|
_tcsncicmp |
_strnicmp |
_mbsnicmp |
_wcsnicmp |
_tcsnicmp |
_strnicmp |
_mbsnbicmp |
_wcsnicmp |
_tcsncicmp_l |
_strnicmp_l |
_mbsnicmp_l |
_wcsnicmp_l |
Требования
Функция |
Требуемый заголовок |
---|---|
_strnicmp, _strnicmp_l |
<string.h> |
_wcsnicmp, _wcsnicmp_l |
<string.h> или <wchar.h> |
_mbsnicmp, _mbsnicmp_l |
<mbstring.h> |
Для дополнительных данных о совместимости см. в разделе Совместимость.
Пример
См. пример в разделе strncmp.
Эквивалент в .NET Framework
См. также
Ссылки
strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l