共用方式為

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 所指向 pszStr2 所擷取的字元串，則傳回正值。 如果從 pszStr1 所指向的字串串， 的字串依字母順序小於從 pszStr2 所指向的字串，則傳回負值 pszStr2。

言論

請注意，StrCmpNC 是針對比較標準字串而設計的。 這些字串不會當地語系化，而且只包含 ASCII 值 128 以下的字元。 因此，它無法正確使用雙位元組字元集 （DBCS） 或其他多字元數據運作。

此函式會找出第一個不相等字元，如果第一個字元串中的字元大於第二個字元，則傳回正數;如果小於，則傳回負數;如果字元相等，則傳回零。 例如，假設 pszStr1=“abczb”，pszStr2=“abcdefg”，而且您比較每個字元的前四個字符。 StrCmpNC 會判斷第一個不相等字元位於 pszStr1 中的第四個位置（pszStr1 中為 “d”，並在 pszStr2中傳回正值，因為 “z” 的 ASCII 代碼大於 “d” 的 ASCII 代碼。

對於 Shlwapi.h 中不包含 StrCmpNC 的 Windows 版本，必須直接從 Shlwapi.dll呼叫此函式的個別 ANSI 或 Unicode 版本。 StrCmpNCA 為序數 151，而 strCmpNCW 為序數 152。

注意

shlwapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 StrCmpNC 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shlwapi.h
連結庫 Shlwapi.lib
DLL Shlwapi.dll 版 （5.0 版或更新版本）

另請參閱

CompareString

StrCmpC

StrCmpN