lstrcmpW 函式 (winbase.h)

比較兩個字元字串。比較會區分大小寫。

若要執行不區分大小寫的比較，請使用 lstrcmpi 函式。

語法

int lstrcmpW(
  [in] LPCWSTR lpString1,
  [in] LPCWSTR lpString2
);

[in] lpString1

類型： LPCTSTR

要比較的第一個 Null 終止字串。

[in] lpString2

類型： LPCTSTR

要比較的第二個 Null 終止字串。

類型： int

如果 lpString1 所指向的字串小於 lpString2所指向的字串，則傳回值為負值。如果 lpString1 所指向的字串大於 lpString2所指向的字串，則傳回值為正數。如果字串相等，則傳回值為零。

lstrcmp函式會藉由檢查第一個字元彼此比較、第二個字元彼此比較，依此類推，直到找到不相等或到達字串的結尾為止。

請注意， lpString1 和 lpString2 參數必須以 Null 終止，否則字串比較可能不正確。

函式會使用目前的執行緒地區設定來呼叫 CompareStringEx，並從結果中減去 2，以維護比較字串的 C 執行時間慣例。

語言 (使用者地區設定) 在設定時間或透過主控台選取的使用者地區設定，會決定哪一個字串大於 (或字串是否為相同的) 。如果未選取任何語言 (使用者地區設定) ，系統會使用預設值來執行比較。

使用雙位元組字元集 (DBCS) 版本的系統，此函式可以比較兩個 DBCS 字串。

lstrcmp函式會使用字組排序，而不是字串排序。單字排序會以不同于其處理非英數位元的其他符號來處理連字號和單引號，以確保「coop」和「co-op」之類的單字會保持在排序的清單中。如需字組排序和字串排序的詳細討論，請參閱處理應用程式中的排序。

如需有關比較函式選擇的安全性考慮，請參閱安全性考慮：國際功能。

注意

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


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll