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

Статья
11/20/2024

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

Синтаксис

int StrCmpCA(
  [out] LPCSTR pszStr1,
  [out] LPCSTR pszStr2
);

Параметры

[out] pszStr1

Тип: LPCSTR

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

[out] pszStr2

Тип: LPCSTR

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

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

Тип: int

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

Замечания

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

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

Для этих версий Windows, которые не включают StrCmpC в Shlwapi.h, отдельная версия ANSI или Юникода должна вызываться непосредственно из Shlwapi.dll. StrCmpCA порядковый номер 155 и StrCmpCW порядковый номер 156.

Заметка

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

Требования

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

См. также

CompareString

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