StrIsIntlEqualA-Funktion (shlwapi.h)

Artikel
08/26/2023

Vergleicht eine angegebene Anzahl von Zeichen vom Anfang von zwei Zeichenfolgen, um zu bestimmen, ob sie gleich sind.

Syntax

BOOL StrIsIntlEqualA(
       BOOL  fCaseSens,
  [in] PCSTR pszString1,
  [in] PCSTR pszString2,
       int   nChar
);

Parameter

fCaseSens

Typ: BOOL

Die Groß-/Kleinschreibung des Vergleichs. Wenn dieser Wert ungleich null ist, wird beim Vergleich die Groß-/Kleinschreibung beachtet. Wenn dieser Wert 0 ist, wird beim Vergleich die Groß-/Kleinschreibung nicht beachtet.

[in] pszString1

Typ: PCTSTR

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

[in] pszString2

Typ: PCTSTR

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: BOOL

TRUE , wenn die ersten nChar-Zeichen aus den beiden Zeichenfolgen gleich sind; andernfalls FALSE.

Hinweise

Sie können die Groß-/Kleinschreibung mit den Makros StrIntlEqN und StrIntlEqNI festlegen. StrIntlEqN führt einen Vergleich zwischen Groß- und Kleinschreibung durch, und StrIntlEqNI führt einen Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung durch.

Die Syntax der beiden Makros lautet:

#define StrIntlEqN(s1, s2, nChar) StrIsIntlEqual(TRUE, s1, s2, nChar)
#define StrIntlEqNI(s1, s2, nChar) StrIsIntlEqual(FALSE, s1, s2, nChar)

Hinweis

Der shlwapi.h-Header definiert StrIsIntlEqual 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 4.71 oder höher)

Share via