StrCmpICA-Funktion (shlwapi.h)

  • Artikel

Vergleicht zwei Zeichenfolgen mithilfe von ASCII-Sortierungsregeln (C-Laufzeit). Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.

Syntax

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

Parameter

[in] pszStr1

Typ: LPCTSTR

Ein Zeiger auf die erste null-endende Zeichenfolge, die verglichen werden soll.

[in] pszStr2

Typ: LPCTSTR

Ein Zeiger auf die zweite null-endende 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 lpStr1 zeigt, alphabetisch größer ist als die Zeichenfolge, auf die lpStr2 zeigt. Gibt einen negativen Wert zurück, wenn die Zeichenfolge, auf die lpStr1 zeigt, alphabetisch kleiner ist als die von lpStr2.

Hinweise

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 er 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 Vergleich der konvertierten Werte. Diese Funktion gibt den Wertunterschied der ersten ungleichen Zeichen zurück, auf die sie trifft, oder null, wenn sie alle gleich sind. Wenn z. B . lpStr1="abczb" und lpStr2="abcdefg", bestimmt StrCmpIC , dass "abczb" größer als "abcdefg" ist, und gibt z - d zurück.

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

Hinweis

Der shlwapi.h-Header 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
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.0 oder höher)

Weitere Informationen

CompareString