lstrcmpA-Funktion (winbase.h)

Artikel
03/06/2024

Vergleicht zwei Zeichenfolgen. Beim Vergleich wird die Groß-/Kleinschreibung beachtet.

Verwenden Sie die lstrcmpi-Funktion , um einen Vergleich durchzuführen, bei dem die Groß-/Kleinschreibung nicht beachtet wird.

Syntax

int lstrcmpA(
  [in] LPCSTR lpString1,
  [in] LPCSTR lpString2
);

Parameter

[in] lpString1

Typ: LPCTSTR

Die erste null-endende Zeichenfolge, die verglichen werden soll.

[in] lpString2

Typ: LPCTSTR

Die zweite null-endende Zeichenfolge, die verglichen werden soll.

Rückgabewert

Typ: int

Wenn die Zeichenfolge, auf die von lpString1 verwiesen wird, kleiner ist als die Zeichenfolge, auf die lpString2 verweist, ist der Rückgabewert negativ. Wenn die Zeichenfolge, auf die von lpString1 verwiesen wird, größer ist als die Zeichenfolge, auf die lpString2 verweist, ist der Rückgabewert positiv. Wenn die Zeichenfolgen gleich sind, ist der Rückgabewert null.

Hinweise

Die lstrcmp-Funktion vergleicht zwei Zeichenfolgen, indem sie die ersten Zeichen miteinander überprüft, die zweiten Zeichen gegeneinander usw., bis sie eine Ungleichheit findet oder die Enden der Zeichenfolgen erreicht.

Beachten Sie, dass die Parameter lpString1 und lpString2 null-terminated sein müssen. Andernfalls kann der Zeichenfolgenvergleich falsch sein.

Die Funktion ruft CompareStringEx unter Verwendung des aktuellen Threadgebietsschemas auf und subtrahiert 2 vom Ergebnis, um die C-Laufzeitkonventionen für den Vergleich von Zeichenfolgen beizubehalten.

Die Sprache (Benutzergebietsschema), die vom Benutzer zur Einrichtungszeit oder über Systemsteuerung ausgewählt wurde, bestimmt, welche Zeichenfolge größer ist (oder ob die Zeichenfolgen identisch sind). Wenn keine Sprache (Benutzergebietsschema) ausgewählt ist, führt das System den Vergleich mithilfe von Standardwerten durch.

Mit einer DBCS-Version (Double-Byte Character Set) des Systems kann diese Funktion zwei DBCS-Zeichenfolgen vergleichen.

Die lstrcmp-Funktion verwendet eine Wortsortierung anstelle einer Zeichenfolgensortierung. Eine Wortsortierung behandelt Bindestriche und Apostrophe anders als andere Symbole, die nicht alphanumerisch sind, um sicherzustellen, dass Wörter wie "coop" und "co-op" innerhalb einer sortierten Liste zusammenbleiben. Eine ausführliche Erläuterung der Wort- und Zeichenfolgensortierungen finden Sie unter Behandeln der Sortierung in Ihren Anwendungen.

Sicherheitsbemerkungen

Sicherheitsüberlegungen zur Auswahl von Vergleichsfunktionen finden Sie unter Sicherheitsüberlegungen: Internationale Features .

Hinweis

Der winbase.h-Header definiert lstrcmp als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll