System.SysUtils.TextToFloat

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function TextToFloat(Buffer: PWideChar; var Value; ValueType: TFloatValue): Boolean;
function TextToFloat(Buffer: PWideChar; var Value;
ValueType: TFloatValue; const AFormatSettings: TFormatSettings): Boolean;
function TextToFloat(Buffer: PAnsiChar; var Value; ValueType: TFloatValue): Boolean;
function TextToFloat(Buffer: PAnsiChar; var Value;
ValueType: TFloatValue; const AFormatSettings: TFormatSettings): Boolean;
function TextToFloat(const S: string; var Value: Extended): Boolean;
function TextToFloat(const S: string; var Value: Extended;
const AFormatSettings: TFormatSettings): Boolean;
function TextToFloat(const S: string; var Value: Double): Boolean;
function TextToFloat(const S: string; var Value: Double;
const AFormatSettings: TFormatSettings): Boolean;
function TextToFloat(const S: string; var Value: Currency): Boolean;
function TextToFloat(const S: string; var Value: Currency;
const AFormatSettings: TFormatSettings): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall TextToFloat(System::WideChar * Buffer, void *Value, TFloatValue ValueType)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Beschreibung

Warnung: Die ANSI-Version von TextToFloat ist veraltet. Bitte verwenden Sie die AnsiStrings-Unit.

Konvertiert einen nullterminierten String in einen Gleitkommawert.

Mit TextToFloat kann der nullterminierte String Buffer in einen Gleitkommawert konvertiert werden. Der String muss aus einem optionalen Vorzeichen (+ oder -), einem String mit Ziffern und einem optionalen Dezimaltrennzeichen sowie aus einer optionalen Mantisse bestehen. Die Mantisse setzt sich aus 'E' oder 'e', einem optionalen Vorzeichen und einer ganzen Zahl zusammen. Leerzeichen am Anfang und Ende werden ignoriert.

Der konvertierte Wert wird dem Parameter Value zugewiesen. Dieser muss je nach Wert des Parameters ValueType den Typ Extended oder Currency haben.

TextToFloat gibt True zurück, wenn die Konvertierung durchgeführt werden konnte. Wenn Buffer keinen gültigen Gleitkommawert enthält, wird False zurückgegeben.

Die erste Form von TextToFloat ist nicht Thread-sicher, da die landesspezifischen Informationen der globalen Variablen verwendet werden. Der Thread-sicheren zweiten Form werden die landesspezifischen Informationen im Parameter AFormatSettings übergeben. Bevor Sie diese Form von TextToFloat aufrufen, müssen Sie die Informationen in den Parameter AFormatSettings schreiben. Die landesspezifischen Standardinformationen können AFormatSettings mit TFormatSettings.Create zugewiesen werden.

Codebeispiele