StrCmpNICW-Funktion (shlwapi.h)
Vergleicht eine angegebene Anzahl von Zeichen vom Anfang von zwei Zeichenfolgen mithilfe von C-Laufzeitregeln (ASCII)-Sortierregeln. Bei dem Vergleich wird die Groß-/Kleinschreibung nicht beachtet.
Syntax
int StrCmpNICW(
[in] LPCWSTR pszStr1,
[in] LPCWSTR pszStr2,
int nChar
);
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.
nChar
Typ: int
Die Anzahl der Zeichen vom Anfang jeder zu vergleichenden Zeichenfolge.
Rückgabewert
Typ: int
Gibt Null zurück, wenn die Teilzeichenfolgen identisch sind. Gibt einen positiven Wert zurück, wenn die Zeichenfolge, die von pszStr1 verweist, alphabetisch größer ist die Zeichenfolge, die von pszStr2. Gibt einen negativen Wert zurück, wenn die Zeichenfolge, die von pszStr1 verweist, alphabetisch kleiner als die Zeichenfolge, die von pszStr2verweist.
Bemerkungen
Beachten Sie, dass StrCmpNIC- für den Vergleich kanonischer Zeichenfolgen entwickelt wurde. Diese Zeichenfolgen sind nicht lokalisiert und bestehen nur aus Zeichen unterhalb des ASCII-Werts 128. Daher funktioniert sie nicht ordnungsgemäß mit einem Doppelbyte-Zeichensatz (DOUBLE-Byte Character Set, DBCS) oder anderen Daten mit mehreren Zeichen.
Diese Funktion sucht die ersten ungleichen Zeichen und gibt eine positive Zahl zurück, wenn das Zeichen aus der ersten Zeichenfolge größer als das Zeichen der zweiten ist, eine negative Zahl, wenn sie kleiner oder null ist, wenn sie gleich sind. Angenommen, pszStr1="abczb", pszStr2="abcdefg", und Sie vergleichen die ersten vier Zeichen aus jedem. StrCmpNIC bestimmt, dass sich das erste ungleiche Zeichen an Position 4 befindet ("z" in pszStr1 und "d" in pszStr2) und gibt einen positiven Wert zurück, da der ASCII-Code für "z" größer als der ASCII-Code für "d" ist.
Für windows-Versionen, die StrCmpNIC- in Shlwapi.h nicht enthalten, muss die individuelle ANSI- oder Unicode-Version dieser Funktion direkt aus Shlwapi.dllaufgerufen werden. StrCmpNICA ist Ordnungszahl 153 und StrCmpNICW ist Ordnungszahl 154.
Anmerkung
Der Header "shlwapi.h" definiert StrCmpNIC 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) |