StrCmpNICW-Funktion (shlwapi.h)

  • Artikel

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

Syntax

int StrCmpNICW(
  [in] LPCWSTR pszStr1,
  [in] LPCWSTR pszStr2,
       int     nChar
);

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.

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 stammt, alphabetisch größer ist als die Zeichenfolge, auf die von pszStr2 verwiesen wird. Gibt einen negativen Wert zurück, wenn die Zeichenfolge, die von pszStr1 stammt, alphabetisch kleiner ist als die Zeichenfolge, die aus der von pszStr2 abgeleiteten Zeichenfolge stammt.

Hinweise

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 er nicht ordnungsgemäß mit einem Double-Byte-Zeichensatz (DBCS) oder anderen Mehrzeichendaten.

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 aus der zweiten ist, eine negative Zahl, wenn sie kleiner oder null ist, wenn sie gleich sind. Angenommen, pszStr1="abczb", pszStr2="abcdefg", und Sie vergleichen jeweils die ersten vier Zeichen. 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 nicht in Shlwapi.h enthalten, muss die einzelne ANSI- oder Unicode-Version dieser Funktion direkt aus Shlwapi.dll aufgerufen werden. StrCmpNICA hat die Ordnungszahl 153 und StrCmpNICW die Ordnungszahl 154.

Hinweis

Der shlwapi.h-Header 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

   
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

StrCmpIC

StrCmpNI