lstrcmpA 函式 (winbase.h)

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

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

語法

int lstrcmpA(
  [in] LPCSTR lpString1,
  [in] LPCSTR 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 標頭會根據 UNICODE 預處理器常數的定義，將 lstrcmp 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。