StrCmpICW-Funktion (shlwapi.h)
Vergleicht zwei Zeichenfolgen unter Verwendung von ASCII-Sortierungsregeln (C-Laufzeit). Beim Vergleich wird die Groß-/Kleinschreibung nicht berücksichtigt.
Syntax
int StrCmpICW(
[in] LPCWSTR pszStr1,
[in] LPCWSTR pszStr2
);
Parameter
[in] pszStr1
Typ: LPCTSTR
Ein Zeiger auf die erste NULL-Zeichenfolge, die verglichen werden soll.
[in] pszStr2
Typ: LPCTSTR
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, 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 es bei DBCS-Daten (Double-Byte Character Set) nicht ordnungsgemäß.
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, oder null, wenn sie alle gleich sind. Wenn beispielsweise lpStr1="abczb" und lpStr2="abcdefg", StrCmpIC bestimmt, dass "abczb" größer als "abcdefg" ist und gibt z - d zurück.
Für windows-Versionen, die StrCmpIC in Shlwapi.h nicht enthalten, muss die individuelle ANSI- oder Unicode-Version dieser Funktion direkt von Shlwapi.dll aufgerufen werden. StrCmpICA ist Ordnungszahl 157 und StrCmpICW ist Ordnungszahl 158.
Hinweis
Der shlwapi.h-Header definiert StrCmpIC als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für