StrCmpNCW 函数 (shlwapi.h)

  • 项目

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

语法

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

参数

[in] pszStr1

类型： LPCTSTR

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

[in] pszStr2

类型： LPCTSTR

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

nChar

类型： int

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

返回值

类型： int

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

注解

请注意， StrCmpNC 旨在比较规范字符串。 这些字符串未本地化，仅包含 ASCII 值 128 以下的字符。 因此，对于双字节字符集 (DBCS) 或其他多字符数据，它将无法正常运行。

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

对于 Shlwapi.h 中不包含 StrCmpNC 的 Windows 版本，必须直接从 Shlwapi.dll 调用此函数的单个 ANSI 或 Unicode 版本。 StrCmpNCA 为序号 151，StrCmpNCW 为序号 152。

注意

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

要求

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

另请参阅

CompareString

StrCmpC

StrCmpN