FloatToText

Return a string representation of a float, with a given format.

Declaration

Source position: sysstrh.inc line 212

  function FloatToText(Buffer: PChar; Value: Extended; 
                      format: TFloatFormat; Precision: Integer; 
                      Digits: Integer) : LongInt;
  function FloatToText(Buffer: PChar; Value: Extended; 
                      format: TFloatFormat; Precision: Integer; 
                      Digits: Integer; 
                      const FormatSettings: TFormatSettings) : LongInt;

Description

FloatToText converts the floating point variable Value to a string representation and stores it in Buffer. The conversion is governed by format, Precision and Digits. more information on these parameters can be found in FloatToStrF . Buffer should point to enough space to hold the result. No checking on this is performed.

The result is the number of characters that was copied in Buffer.

Errors

None.

See also

Name Description
FloatToStr Convert a float value to a string using a fixed format.
FloatToStrF Convert a float value to a string using a given format.

Example

Program Example68;
{ This program demonstrates the FloatToStrF function }
Uses sysutils;
Const Fmt : Array [TFloatFormat] of string[10] =
         ('general','exponent','fixed','number','Currency');
Procedure Testit (Value :  Extended);
Var I,J : longint;
    FF : TFloatFormat;
    S : ShortString;
begin
  For I:=5 to 15 do
    For J:=1 to 4 do
      For FF:=ffgeneral to ffcurrency do
        begin
        Write (Value,'(Prec: ',I:2,', Dig: ',J,', fmt : ',Fmt[ff],') : ');
        SetLength(S,FloatToText (@S[1],Value,FF,I,J));
        Writeln (S);
        Write (-Value,'(Prec: ',I:2,', Dig: ',J,', fmt : ',Fmt[ff],') : ');
        SetLength(S,FloatToText (@S[1],-Value,FF,I,J));
        Writeln (S);
        end;
end;
Begin
  Testit (1.1);
  Testit (1.1E1);
  Testit (1.1E-1);
  Testit (1.1E5);
  Testit (1.1E-5);
  Testit (1.1E10);
  Testit (1.1E-10);
  Testit (1.1E15);
  Testit (1.1E-15);
  Testit (1.1E100);
  Testit (1.1E-100);
End.