_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Статья
04/10/2013

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

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

int _strnicoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicoll(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count 
);
int _mbsnicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicoll_l(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count,
   _locale_t locale
);
int _mbsnicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

Параметры

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

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

Каждая из этих функций возвращает значение, указывающее связь подстрок string1 и string2 следующим образом.

Возвращаемое значение	Связь string1 и string2
< 0	string1 меньше чем string2.
0	string1 идентична string2.
> 0	string1 больше чем string2.

Каждая из этих функций возвращает _NLSCMPERROR.Чтобы использовать _NLSCMPERROR, включить или STRING.H или MBSTRING.H._wcsnicoll может завершиться неудачей, если string1 или string2 содержат коды юникода вне домена collating последовательности.При возникновении ошибки, _wcsnicoll можно задать для errno значение EINVAL.Для проверки ошибок при вызове _wcsnicoll, присвойте параметру errno значение 0, а затем проверьте errno после вызова метода _wcsnicoll**.**

Заметки

Каждая из этих функций выполняет сравнения без учета регистра первых символов count в string1 и string2 согласно кодовую страницу.Эти функции следует использовать только в том случае, когда различие между порядком кодировки и лексикографическим порядком символов в кодовой странице и данного отличия представляет интерес для сравнения строк.Версии этих функций без суффикса _l используют текущий языковой стандарт и кодовую страницу.Версии с суффиксом _l идентичны за исключением того, что они используют языковой стандарт, вместо этого в.Для получения дополнительной информации см. Языковой стандарт.

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

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