Функция StrCmpICA (shlwapi.h)

  • Статья

Сравнивает две строки с помощью правил сортировки времени выполнения C (ASCII). Сравнение выполняется без учета регистра.

Синтаксис

int StrCmpICA(
  [in] LPCSTR pszStr1,
  [in] LPCSTR pszStr2
);

Параметры

[in] pszStr1

Тип: LPCTSTR

Указатель на первую строку, завершаемую значением NULL, для сравнения.

[in] pszStr2

Тип: LPCTSTR

Указатель на вторую строку со значением NULL для сравнения.

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

Тип: int

Возвращает ноль, если строки идентичны. Возвращает положительное значение, если строка, на которую указывает lpStr1 , в алфавитном порядке больше строки, на которую указывает lpStr2. Возвращает отрицательное значение, если строка, на которую указывает lpStr1, в алфавитном порядке меньше строки, указанной в lpStr2.

Комментарии

Настоятельно рекомендуется использовать CompareString вместо этой функции. StrCmpIC был разработан для сравнения канонических строк. Эти строки не локализованы и состоят только из символов ниже значения ASCII 128. Таким образом, он не будет правильно работать с данными двухбайтовой кодировки (DBCS).

Символы верхнего регистра преобразуются в символы нижнего регистра перед сравнением, а возвращаемое значение основано на сравнении преобразованных значений. Эта функция возвращает разницу в значении первых неравных символов, которые она встречает, или ноль, если все они равны. Например, если lpStr1="abczb" и lpStr2="abcdefg", StrCmpIC определяет, что "abczb" больше "abcdefg", и возвращает z - d.

Для тех версий Windows, которые не содержат StrCmpIC в Shlwapi.h, отдельная версия этой функции ANSI или Юникода должна вызываться непосредственно из Shlwapi.dll. StrCmpICA имеет порядковый номер 157, а StrCmpICW — порядковый номер 158.

Примечание

Заголовок shlwapi.h определяет StrCmpIC как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 5.0 или более поздняя)

См. также раздел

CompareString