StrCmpNICW 函数 (shlwapi.h)

  • 项目

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

语法

int StrCmpNICW(
  [in] LPCWSTR pszStr1,
  [in] LPCWSTR pszStr2,
       int     nChar
);

参数

[in] pszStr1

类型： LPCTSTR

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

[in] pszStr2

类型： LPCTSTR

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

nChar

类型： int

要比较的每个字符串开头的字符数。

返回值

类型： int

如果子字符串相同，则返回零。 如果从 pszStr1 指向的字符串的字母顺序大于 pszStr2 从该指向的字符串，则返回一个正值。 如果从 pszStr1 指向的字符串的字母顺序小于 pszStr2 所指向的字符串，则返回负值。

注解

请注意， StrCmpNIC 设计用于比较规范字符串。 这些字符串未本地化，仅包含低于 ASCII 值 128 的字符。 因此，当 DBCS) 或其他多字符数据 (双字节字符集时，它将无法正常工作。

此函数查找第一个不相等字符，如果第一个字符串中的字符大于第二个字符串中的字符，则返回一个正数;如果小于，则返回负数;如果相等，则返回零。 例如，假设 pszStr1=“abczb”， pszStr2=“abcdefg”，并比较每个字符的前四个字符。 StrCmpNIC 确定第一个不相等字符在 pszStr1 中位于 4 (“z”，在 pszStr2) 中为“d”，并返回一个正值，因为“z”的 ASCII 代码大于“d”的 ASCII 代码。

对于 Shlwapi.h 中不包含 StrCmpNIC 的 Windows 版本，必须直接从 Shlwapi.dll 调用此函数的单个 ANSI 或 Unicode 版本。 StrCmpNICA 为序号 153， StrCmpNICW 为序号 154。

注意

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

要求

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

另请参阅

CompareString

StrCmpIC

StrCmpNI