StrCmpICA 函数 (shlwapi.h)

  • 项目

使用 C 运行时 (ASCII) 排序规则比较两个字符串。 该比较不区分大小写。

语法

int StrCmpICA(
  [in] LPCSTR pszStr1,
  [in] LPCSTR pszStr2
);

参数

[in] pszStr1

类型： LPCTSTR

指向要比较的第一个以 null 结尾的字符串的指针。

[in] pszStr2

类型： LPCTSTR

指向要比较的第二个以 null 结尾的字符串的指针。

返回值

类型： int

如果字符串相同，则返回零。 如果 lpStr1 指向的字符串按字母顺序大于 lpStr2 所指向的字符串，则返回一个正值。 如果 lpStr1 指向的字符串按字母顺序小于 lpStr2 指向的字符串，则返回负值

注解

强烈建议使用 CompareString 代替此函数。 StrCmpIC 旨在比较规范字符串。 这些字符串未本地化，仅包含低于 ASCII 值 128 的字符。 因此，当双字节字符集 (DBCS) 数据时，它将无法正常工作。

在比较之前，会将大写字符转换为小写字符，返回值基于比较转换后的值。 此函数返回它遇到的第一个不相等字符的值差;如果它们都相等，则返回零。 例如，如果 lpStr1=“abczb”和 lpStr2=“abcdefg”， 则 StrCmpIC 确定“abczb”大于“abcdefg”并返回 z - d。

对于 Shlwapi.h 中不包含 StrCmpIC 的 Windows 版本，必须直接从 Shlwapi.dll 调用此函数的单个 ANSI 或 Unicode 版本。 StrCmpICA 为序号 157，StrCmpICW 为序号 158。

注意

shlwapi.h 标头将 StrCmpIC 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
Library Shlwapi.lib
DLL Shlwapi.dll (5.0 或更高版本)

另请参阅

CompareString