lstrcmpiW 函式（winbase.h）

發行項
11/20/2024

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

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

語法

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

參數

[in] lpString1

類型：LPCWSTR

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

[in] lpString2

類型：LPCWSTR

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

傳回值

類型：int

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

言論

lstrcmpi 函式會比較兩個字元串，方法是檢查第一個字元彼此、彼此對第二個字元等等，直到它找到不相等或到達字元串的結尾為止。

請注意，lpString1 和 lpString2 參數必須以 null 結束，否則字元串比較可能不正確。

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

對於某些地區設定，lstrcmpi 函式可能不足。如果發生這種情況，請使用 CompareStringEx 來確保適當的比較。例如，在日本使用 NORM_IGNORECASE、NORM_IGNOREKANATYPE和 NORM_IGNOREWIDTH 值呼叫，以達到最適當的非精確字串比較。非亞洲地區設定會忽略 NORM_IGNOREKANATYPE 和 NORM_IGNOREWIDTH 值，因此您可以為所有地區設定設定這些值，並保證不論地區設定為何，都有文化上正確的「不區分」排序。請注意，指定這些值會讓效能變慢，因此只有在需要時才使用這些值。

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

lstrcmpi 函式會使用文字排序，而不是字串排序。單字排序會以不同於其處理非英數位元的其他符號來處理連字元和單引號，以確保 “coop” 和 “co-op” 等單字會保持在排序列表中。如需文字排序和字串排序的詳細討論，請參閱在您的應用程式中處理排序。

安全性備註

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

注意

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

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winbase.h （包括 Windows.h）
連結庫	Kernel32.lib
DLL	Kernel32.dll