Функция StrCmpNCW (shlwapi.h)
Сравнивает указанное количество символов из начала двух строк с помощью правил сортировки во время выполнения C (ASCII). Сравнение учитывает регистр.
Синтаксис
int StrCmpNCW(
[in] LPCWSTR pszStr1,
[in] LPCWSTR pszStr2,
int nChar
);
Параметры
[in] pszStr1
Тип: LPCTSTR
Указатель на первую строку, завершаемую значением NULL, для сравнения.
[in] pszStr2
Тип: LPCTSTR
Указатель на вторую строку со значением NULL для сравнения.
nChar
Тип: int
Число символов от начала каждой сравниваемой строки.
Возвращаемое значение
Тип: int
Возвращает ноль, если подстроки идентичны. Возвращает положительное значение, если строка, взятая из , на которую указывает pszStr1 , в алфавитном порядке больше строки, взятой из строки, на которую указывает pszStr2. Возвращает отрицательное значение, если строка, взятая из , на которую указывает pszStr1 , в алфавитном порядке меньше строки, взятой из строки, на которую указывает pszStr2.
Комментарии
Обратите внимание, что StrCmpNC был разработан для сравнения канонических строк. Эти строки не локализованы и состоят только из символов ниже значения ASCII 128. Поэтому он не будет правильно работать с двухбайтовой кодировкой (DBCS) или другими многосимвыми данными.
Эта функция находит первые неравные символы и возвращает положительное число, если символ из первой строки больше символа из второй, отрицательное число, если оно меньше, или ноль, если они равны. Например, предположим, что pszStr1="abczb", pszStr2="abcdefg", и вы сравниваете первые четыре символа из каждого из них. StrCmpNC определяет, что первый неравный символ находится в четвертой позиции ("z" в pszStr1 и "d" в pszStr2), и возвращает положительное значение, так как код ASCII для "z" больше кода ASCII для "d".
Для тех версий Windows, которые не содержат StrCmpNC в Shlwapi.h, отдельная версия функции ANSI или Юникода должна вызываться непосредственно из Shlwapi.dll. StrCmpNCA имеет порядковый номер 151, а StrCmpNCW — порядковый номер 152.
Примечание
Заголовок shlwapi.h определяет StrCmpNC как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shlwapi.h |
| Библиотека | Shlwapi.lib |
| DLL | Shlwapi.dll (версия 5.0 или более поздняя) |