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

Статья
11/20/2024

Сравнивает указанное число символов с начала двух строк, чтобы определить, совпадают ли они. Сравнение учитывает регистр. Макрос StrNCmp отличается от этой функции только в имени.

Синтаксис

int StrCmpNA(
  [in] PCSTR psz1,
  [in] PCSTR psz2,
  [in] int   nChar
);

Параметры

[in] psz1

Тип: PCTSTR

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

[in] psz2

Тип: PCTSTR

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

[in] nChar

Тип: int

Число символов с начала каждой строки, которые необходимо сравнить.

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

Тип: int

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

Замечания

Заметка

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

Требования

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

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