StrCmpICA-Funktion (shlwapi.h)

Artikel
11/20/2024

Vergleicht zwei Zeichenfolgen mit C-Laufzeitregeln (ASCII). Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.

Syntax

int StrCmpICA(
  [in] LPCSTR pszStr1,
  [in] LPCSTR pszStr2
);

Parameter

[in] pszStr1

Typ: LPCTSTR-

Ein Zeiger auf die erste mit Null beendete Zeichenfolge, die verglichen werden soll.

[in] pszStr2

Typ: LPCTSTR-

Ein Zeiger auf die zweite mit Null beendete Zeichenfolge, die verglichen werden soll.

Rückgabewert

Typ: int

Gibt Null zurück, wenn die Zeichenfolgen identisch sind. Gibt einen positiven Wert zurück, wenn die Zeichenfolge, auf die durch lpStr1 verweist, alphabetisch größer ist als auf lpStr2verweist. Gibt einen negativen Wert zurück, wenn die Zeichenfolge, auf die von lpStr1 verweist, alphabetisch kleiner ist als auf lpStr2

Bemerkungen

Es wird dringend empfohlen, CompareString- anstelle dieser Funktion zu verwenden. StrCmpIC wurde für den Vergleich kanonischer Zeichenfolgen entwickelt. Diese Zeichenfolgen sind nicht lokalisiert und bestehen nur aus Zeichen unterhalb des ASCII-Werts 128. Daher funktioniert sie nicht ordnungsgemäß mit DBCS-Daten (Double-Byte Character Set).

Großbuchstaben werden vor dem Vergleich in Kleinbuchstaben konvertiert, und der Rückgabewert basiert auf dem Vergleichen der konvertierten Werte. Diese Funktion gibt die Differenz des Werts der ersten ungleichen Zeichen zurück, auf die sie stoßen, oder null, wenn sie alle gleich sind. Wenn z. B. lpStr1="abczb" und lpStr2="abcdefg", StrCmpIC bestimmt, dass "abczb" größer als "abcdefg" ist und z - d zurückgibt.

Für Windows-Versionen, die StrCmpIC- in Shlwapi.h nicht enthalten, muss die individuelle ANSI- oder Unicode-Version dieser Funktion direkt aus Shlwapi.dllaufgerufen werden. StrCmpICA ist Ordnungszahl 157 und StrCmpICW ist Ordnungszahl 158.

Anmerkung

Der Header "shlwapi.h" definiert StrCmpIC 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
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)

Siehe auch

CompareString-

Freigeben über