StrToIntExW-Funktion (shlwapi.h)

Artikel
03/04/2024

Konvertiert eine Zeichenfolge, die eine Dezimal- oder Hexadezimalzahl 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 zu konvertierende NULL-endende Zeichenfolge. Weitere Informationen zu den gültigen Formularen der Zeichenfolge finden Sie im Abschnitt Hinweise.

dwFlags

Typ: STIF_FLAGS

Einer der folgenden Werte, der angibt, wie pszString für seine 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 bei den Zeichen A bis F die Groß-/Kleinschreibung nicht beachtet wird.

[out] piRet

Typ: int*

Ein Zeiger auf ein int , das die konvertierte Zeichenfolge empfängt. Bei instance erhält im Fall der Zeichenfolge "123" 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 int enthalten zu sein, enthält dieser Parameter die 32 Bits niedriger Reihenfolge des Werts. Alle darüber hinausgehenden Bits hoher Ordnung gehen verloren.

Rückgabewert

Typ: BOOL

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

Hinweise

Die Zeichenfolge, auf die der pszString-Parameter verweist, muss eine der folgenden Formen aufweisen, um erfolgreich analysiert zu werden.

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

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

Hinweis Wenn der Wert als Hexadezimalwert analysiert wird, wird das optionale Zeichen ignoriert, auch wenn es sich um ein -Zeichen handelt. Beispielsweise wird die Zeichenfolge "-0x1" als 1 statt als -1 analysiert.

Wenn die Zeichenfolge, auf die von pszString verwiesen wird, ein ungültiges Zeichen enthält, wird dieses Zeichen als Ende der zu konvertierenden Zeichenfolge betrachtet, und der Rest wird ignoriert. Bei instance erkennt StrToIntEx aufgrund der ungültigen Hexadezimalzeichenfolge "0x00am123" nur "0x00a", konvertiert es in den ganzzahligen Wert 10 und gibt TRUE zurück.

Hinweis

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