StrCmpCA-Funktion (shlwapi.h)

  • Artikel

Vergleicht Zeichenfolgen mithilfe von ASCII-Sortierungsregeln (C-Laufzeit). Beim Vergleich wird die Groß-/Kleinschreibung beachtet.

Syntax

int StrCmpCA(
  [out] LPCSTR pszStr1,
  [out] LPCSTR pszStr2
);

Parameter

[out] pszStr1

Typ: LPCSTR

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

[out] pszStr2

Typ: LPCSTR

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

Hinweise

Es wird dringend empfohlen, anstelle dieser Funktion die CompareString-Funktion zu verwenden. StrCmpC 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 es nicht ordnungsgemäß mit einem Double-Byte-Zeichensatz (DBCS) oder anderen mehrzeichenigen Daten.

Diese Funktion sucht die ersten ungleichen Zeichen und gibt eine positive Zahl zurück, wenn das Zeichen aus der ersten Zeichenfolge größer ist als das Zeichen aus der zweiten, eine negative Zahl, wenn sie kleiner oder null ist, wenn sie gleich sind. Wenn beispielsweise lpStr1="abczb" und lpStr2="abcdefg", StrCmpC ermittelt, dass das erste ungleiche Zeichen an Position vier ("z" in lpStr1 und "d" in lpStr2) liegt und einen positiven Wert zurückgibt, da der ASCII-Code für "z" größer ist als der ASCII-Code für "d".

Für windows-Versionen, die StrCmpC in Shlwapi.h nicht enthalten, muss die individuelle ANSI- oder Unicode-Version dieser Funktion direkt aus Shlwapi.dll aufgerufen werden. StrCmpCA ist Ordnungszahl 155 und StrCmpCW ist Ordnungszahl 156.

Hinweis

Der shlwapi.h-Header definiert StrCmpC 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 nicht codierungsneutralem Code 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