StrToIntW-Funktion (shlwapi.h)

Konvertiert eine Zeichenfolge, die einen Dezimalwert darstellt, in eine ganze Zahl. Das StrToLong-Makro ist mit dieser Funktion identisch.

Syntax

int StrToIntW(
  [in] PCWSTR pszSrc
);

Parameter

[in] pszSrc

Typ: PCTSTR

Ein Zeiger auf die zu konvertierende NULL-endende Zeichenfolge. Eine gültige Zeichenfolge, die einen Dezimalwert darstellt, enthält nur die Zeichen 0-9 und muss die folgende Form aufweisen, um erfolgreich analysiert zu werden.

(optional white space)(optional sign)(one or more decimal digits)

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

Rückgabewert

Typ: int

Gibt den int-Wert zurück, der durch pszSrc dargestellt wird. Für instance gibt die Zeichenfolge "123" den ganzzahligen Wert 123 zurück.

Hinweise

Wenn die Zeichenfolge, auf die von pszSrc 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 StrToInt aufgrund der ungültigen Dezimalzeichenfolge "12b34" nur "12" und gibt diesen ganzzahligen Wert zurück.

Hinweis

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

Weitere Informationen

StrToIntEx