StrToIntExW-Funktion (shlwapi.h)

Artikel
11/20/2024

Konvertiert eine Zeichenfolge, die eine dezimale oder hexadezimale Zahl darstellt, in eine ganze Zahl.

Syntax

BOOL StrToIntExW(
  [in]  PCWSTR     pszString,
        STIF_FLAGS dwFlags,
  [out] int        *piRet
);

Parameter

[in] pszString

Typ: PCTSTR-

Ein Zeiger auf die mit Null beendete Zeichenfolge, die konvertiert werden soll. Weitere Informationen zu den gültigen Formen der Zeichenfolge finden Sie im Abschnitt "Hinweise".

dwFlags

Typ: STIF_FLAGS

Einer der folgenden Werte, die angeben, wie pszString- für die Konvertierung in eine ganze Zahl analysiert werden soll.

STIF_DEFAULT

Die Zeichenfolge bei pszString enthält die Darstellung eines Dezimalwerts.

STIF_SUPPORT_HEX

Die Zeichenfolge bei pszString enthält die Darstellung eines Dezimal- oder Hexadezimalwerts. Beachten Sie, dass bei hexadezimalen Darstellungen die Zeichen A-F die Groß-/Kleinschreibung nicht beachtet.

[out] piRet

Typ: int*

Ein Zeiger auf eine int, die die konvertierte Zeichenfolge empfängt. Bei der Zeichenfolge "123" erhält beispielsweise die ganze Zahl, auf die dieser Wert verweist, den ganzzahligen Wert 123.

Wenn diese Funktion FALSE-zurückgibt, ist dieser Wert nicht definiert.

Wenn der zurückgegebene Wert zu groß ist, um in einer Variablen vom Typ intenthalten zu sein, enthält dieser Parameter die 32 Bits mit niedriger Reihenfolge des Werts. Alle hochgeordneten Bits, die darüber hinausgehen, gehen verloren.

Rückgabewert

Typ: BOOL-

Gibt TRUE- zurück, wenn die Zeichenfolge konvertiert wird; andernfalls FALSE.

Bemerkungen

Die Zeichenfolge, auf die der pszString-Parameter verweist, muss eines der folgenden Formulare aufweisen, damit sie erfolgreich analysiert werden können.

Dieses Formular wird als Dezimalwert unter beiden Kennzeichen akzeptiert. ''' Syntax (optionales Leerzeichen)(optionales Vorzeichen)(eine oder mehrere Dezimalziffern) '''
Diese Formulare sind für Hexadezimalwerte erforderlich, wenn das flag STIF_SUPPORT_HEX übergeben wird. ''' Syntax (optionaler Leerraum)(optionales Zeichen)0x(eine oder mehrere Hexadezimalziffern) '''
```
(optional white space)(optional sign)0X(one or more hexadecimal digits)
```

Das optionale Zeichen kann das Zeichen "-" oder "+" sein; wenn nicht angegeben, wird davon ausgegangen, dass das Vorzeichen positiv ist.

Note If the value is parsed as hexadecimal, the optional sign is ignored, even if it is a '-' character. Beispielsweise wird die Zeichenfolge "-0x1" anstelle von -1 als 1 analysiert.

Wenn die Zeichenfolge, auf die pszString verweist, ein ungültiges Zeichen enthält, wird dieses Zeichen als Das Ende der zu konvertierenden Zeichenfolge betrachtet, und der Rest wird ignoriert. Bei der ungültigen hexadezimalen Zeichenfolge "0x00am123" erkennt StrToIntEx nur "0x00a", konvertiert sie in den ganzzahligen Wert 10 und gibt TRUEzurück.

Anmerkung

Der Header "shlwapi.h" definiert StrToIntEx 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 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 4.71 oder höher)

Freigeben über