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

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

  • Статья

Сравнивает указанное число символов от начала двух строк, чтобы определить, равны ли они.

Синтаксис

BOOL StrIsIntlEqualW(
       BOOL   fCaseSens,
  [in] PCWSTR pszString1,
  [in] PCWSTR pszString2,
       int    nChar
);

Параметры

fCaseSens

Тип: BOOL

Учет регистра при сравнении. Если это значение не равно нулю, в сравнении учитывается регистр. Если это значение равно нулю, при сравнении регистр не учитывается.

[in] pszString1

Тип: PCTSTR

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

[in] pszString2

Тип: PCTSTR

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

nChar

Тип: int

Число символов от начала каждой строки для сравнения.

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

Тип: BOOL

ЗНАЧЕНИЕ TRUE , если первые символы nChar из двух строк равны; в противном случае — FALSE.

Комментарии

Учет регистра можно задать с помощью макросов StrIntlEqN и StrIntlEqNI . StrIntlEqN выполняет сравнение с учетом регистра, а StrIntlEqNI — сравнение без учета регистра.

Синтаксис двух макросов:

#define StrIntlEqN(s1, s2, nChar) StrIsIntlEqual(TRUE, s1, s2, nChar)
#define StrIntlEqNI(s1, s2, nChar) StrIsIntlEqual(FALSE, s1, s2, nChar)

Примечание

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

Требования

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