StrToIntA-Funktion (shlwapi.h)
Konvertiert eine Zeichenfolge, die einen Dezimalwert darstellt, in eine ganze Zahl. Das StrToLong Makro ist identisch mit dieser Funktion.
Syntax
int StrToIntA(
[in] PCSTR pszSrc
);
Parameter
[in] pszSrc
Typ: PCTSTR-
Ein Zeiger auf die mit Null beendete Zeichenfolge, die konvertiert werden soll. Eine gültige Zeichenfolge, die einen Dezimalwert darstellt, enthält nur die Zeichen 0-9 und muss das folgende Formular erfolgreich analysieren lassen.
(optional white space)(optional sign)(one or more decimal digits)
Das optionale Zeichen kann das Zeichen "-" oder "+" sein; wenn nicht angegeben, wird davon ausgegangen, dass das Vorzeichen positiv ist.
Rückgabewert
Typ: int
Gibt den int Wert zurück, der durch pszSrcdargestellt wird. Beispielsweise gibt die Zeichenfolge "123" den ganzzahligen Wert 123 zurück.
Bemerkungen
Wenn die Zeichenfolge, auf die von pszSrc 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 Dezimalzeichenfolge "12b34" erkennt StrToInt nur "12" und gibt diesen ganzzahligen Wert zurück.
Anmerkung
Der Header "shlwapi.h" 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
| 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) |