System.SysUtils.FloatToTextFmt

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function FloatToTextFmt(Buf: PAnsiChar; const Value; ValueType: TFloatValue; Format: PAnsiChar): Integer;
function FloatToTextFmt(Buf: PAnsiChar; const Value; ValueType: TFloatValue;
Format: PAnsiChar; const AFormatSettings: TFormatSettings): Integer;
function FloatToTextFmt(Buf: PWideChar; const Value; ValueType: TFloatValue;
Format: PWideChar): Integer;
function FloatToTextFmt(Buf: PWideChar; const Value; ValueType: TFloatValue;
Format: PWideChar; const AFormatSettings: TFormatSettings): Integer; overload;

C++

extern DELPHI_PACKAGE int __fastcall FloatToTextFmt _DEPRECATED_ATTRIBUTE1("Moved to the AnsiStrings unit") (char * Buf, const void *Value, TFloatValue ValueType, char * Format)/* 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 FloatToTextFmt ist veraltet. Bitte verwenden Sie die AnsiStrings-Unit.

Konvertiert eine Gleitkommazahl in eine Dezimaldarstellung mit dem angegebenen Format.

Mit FloatToTextFmt können Sie die Formatierung eines Gleitkommawertes mit Hilfe eines Format-Strings statt mit einem vordefinierten Format durchführen. Um ein vordefiniertes Format zu verwenden, rufen Sie stattdessen die Funktion FloatToText oder FloatToStrF auf.

Value muss eine Variable des Typs Extended oder Currency sein, wie im Parameter ValueType angegeben. Das Ergebnis ist ein Zeichen-String, der in den angegebenen Puffer gespeichert wird, und der Rückgabewert liefert die Anzahl der gespeicherten Zeichen. Der String ist nicht nullterminiert.

Eine Tabelle mit den unterstützten Formate finden in der Beschreibung der Funktion FormatFloat.

Die erste Form von FloatToTextFmt 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 FloatToTextFmt aufrufen, müssen Sie die Informationen in den Parameter AFormatSettings aufnehmen. Die landesspezifischen Standardinformationen können AFormatSettings mit TFormatSettings.Create zugewiesen werden.

Siehe auch