StrCmpLogicalW-Funktion (shlwapi.h)

Artikel
03/04/2024

Vergleicht zwei Unicode-Zeichenfolgen. Ziffern in den Zeichenfolgen werden als numerischer Inhalt und nicht als Text betrachtet. Bei diesem Test wird die Groß-/Kleinschreibung nicht beachtet.

Syntax

int StrCmpLogicalW(
  [in] PCWSTR psz1,
  [in] PCWSTR psz2
);

Parameter

[in] psz1

Typ: PCWSTR

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

[in] psz2

Typ: PCWSTR

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 1 zurück, wenn die Zeichenfolge, auf die von psz1 verwiesen wird, einen größeren Wert als der wert hat, auf den psz2 verweist.
Gibt -1 zurück, wenn die Zeichenfolge, auf die von psz1 verwiesen wird, einen geringeren Wert aufweist als der wert, auf den psz2 verweist.

Hinweise

Das Reihenfolgeschema dieser Funktion unterscheidet sich etwas von StrCmpI, das auch Zeichenfolgen vergleicht, ohne dass die Groß-/Kleinschreibung beachtet wird. Unter Berücksichtigung von Ziffern anhand ihres numerischen Werts werden Zeichenfolgen wie StrCmpLogicalW wie folgt sortiert:

2string
3string
20string
st2ring
st3ring
st20ring
string2
string3
string20

StrCmpI betrachtet Ziffern in der Zeichenfolge nur als Text, sodass dieselben Zeichenfolgen wie folgt sortiert werden:

20string
2string
3string
st20ring
st2ring
st3ring
string2
string20
string3

Hinweis Das Verhalten dieser Funktion und damit die zurückgegebenen Ergebnisse können sich von Release zu Release ändern. Sie sollte nicht für kanonische Sortieranwendungen verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	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.5 oder höher)

Freigeben über