StrToIntExA-Funktion (shlwapi.h)

Konvertiert eine Zeichenfolge, die eine Dezimal- oder Hexadezimalzahl darstellt, in eine ganze Zahl.

Syntax

BOOL StrToIntExA(
  [in]  PCSTR      pszString,
        STIF_FLAGS dwFlags,
  [out] int        *piRet
);

Parameter

[in] pszString

Typ: PCTSTR

Ein Zeiger auf die zu konvertierende NULL-Zeichenfolge. Weitere Informationen zu den gültigen Formen der Zeichenfolge finden Sie im Abschnitt Hinweise.

dwFlags

Typ: STIF_FLAGS

Einer der folgenden Werte, der angibt, 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 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. Für instance empfängt die ganze Zahl im Fall der Zeichenfolge "123", 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 hinaus geordneten Bits 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 über eines der folgenden Formulare verfügen, um erfolgreich analysiert zu werden.

• Dieses Formular wird als Dezimalwert unter beiden Flags akzeptiert. Syntax ''' (optionaler Leerraum)(optionales Vorzeichen)(eine oder mehrere Dezimalstellen) '''
• Diese Formulare sind für hexadezimale Werte erforderlich, wenn das flag STIF_SUPPORT_HEX übergeben wird. Syntax ''' (optionaler Leerraum)(optionales Vorzeichen)0x(eine oder mehrere Hexadezimalstellen) '''

  (optional white space)(optional sign)0X(one or more hexadecimal digits)
  

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

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 das Ende der zu konvertierenden Zeichenfolge betrachtet, und der Rest wird ignoriert. Bei instance erkennt StrToIntEx aufgrund der ungültigen hexadezimalen Zeichenfolge "0x00am123" nur "0x00a", konvertiert sie 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 nicht codierungsneutralem Code 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 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 4.71 oder höher)