Функция StrCmpCW (shlwapi.h)
Сравнивает строки с помощью правил сортировки времени выполнения C (ASCII). Сравнение учитывает регистр.
Синтаксис
int StrCmpCW(
[out] LPCWSTR pszStr1,
[out] LPCWSTR pszStr2
);
Параметры
[out] pszStr1
Тип: LPCTSTR
Указатель на первую строку, завершаемую значением NULL, для сравнения.
[out] pszStr2
Тип: LPCTSTR
Указатель на вторую строку со значением 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 Professional, Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shlwapi.h |
| Библиотека | Shlwapi.lib |
| DLL | Shlwapi.dll (версия 5.0 или более поздняя) |