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

Статья
11/20/2024

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

Синтаксис

BOOL StrIsIntlEqualA(
       BOOL  fCaseSens,
  [in] PCSTR pszString1,
  [in] PCSTR pszString2,
       int   nChar
);

Параметры

fCaseSens

Тип: BOOL

Конфиденциальность регистра сравнения. Если это значение ненулевое, сравнение учитывает регистр. Если это значение равно нулю, сравнение не учитывает регистр.

[in] pszString1

Тип: PCTSTR

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

[in] pszString2

Тип: PCTSTR

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

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 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)

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