StrToIntA-Funktion (shlwapi.h)
Konvertiert eine Zeichenfolge, die einen Dezimalwert darstellt, in eine ganze Zahl. Das StrToLong-Makro ist mit dieser Funktion identisch.
Syntax
int StrToIntA(
[in] PCSTR pszSrc
);
Parameter
[in] pszSrc
Typ: PCTSTR
Ein Zeiger auf die zu konvertierende NULL-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; wird davon ausgegangen, dass das Vorzeichen positiv ist, wenn es nicht angegeben wird.
Rückgabewert
Typ: int
Gibt den int-Wert zurück, der von 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 das 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 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) |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für