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

Статья
11/20/2024

Сравнивает две строки с использованием правил сортировки времени выполнения 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, эта функция должна вызываться непосредственно из Shlwapi.dll. StrCmpICA порядковый номер 157 и StrCmpICW порядковый номер 158.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя версия)

См. также

CompareString

Поделиться через