strCmpCW 函数 (shlwapi.h)

  • 项目

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

语法

int StrCmpCW(
  [out] LPCWSTR pszStr1,
  [out] LPCWSTR pszStr2
);

参数

[out] pszStr1

类型： LPCTSTR

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

[out] pszStr2

类型： LPCTSTR

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

返回值

类型： int

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

注解

强烈建议使用 CompareString 函数代替此函数。 StrCmpC 旨在比较规范字符串。 这些字符串未本地化，仅包含 ASCII 值 128 以下的字符。 因此，对于双字节字符集 (DBCS) 或其他多字符数据，它将无法正常运行。

此函数查找第一个不相等字符，如果第一个字符串中的字符大于第二个字符串中的字符，则返回一个正数;如果相等，则返回负数;如果相等，则返回零。 例如，如果 lpStr1=“abczb” 和 lpStr2=“abcdefg”， 则 StrCmpC 确定第一个不相等字符位于 lpStr1 中的第 4 (“z”位置，在 lpStr2) 中返回一个正值，因为“z”的 ASCII 代码大于“d”的 ASCII 代码。

对于 Shlwapi.h 中不包含 StrCmpC 的 Windows 版本，必须直接从 Shlwapi.dll 调用此函数的单个 ANSI 或 Unicode 版本。 StrCmpCA 为序号 155，StrCmpCW 为序号 156。

注意

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

要求

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

另请参阅

CompareString