changequote({,}) define({_TITLE_},{Varkon MBS Programmers manual}) define({_SUBTITLE_},{- fval - Function}) define({_INDEXLINK_},{index}) define({_STYLE_},{../varkonstyle.css}) include(../../include/header.inc)

fval - Function

Description

Converts a string of characters to a float value. Leading blanks are ignored but counted together with the number of characters used for conversion. If conversion is not possible a value of zero is returned.

Syntax

  f:=fval(s, status, nchars);

  float  f;
  string s;
  int    status;
  int    nchars;

Principal parameters

s - The string to convert.

Optional parameters

status - 0 => Conversion succsessful, -1 => No conversion possible.
nchars - Number of characters used for conversion.

Return value

A FLOAT value equal to the converted float or zero if conversion was not successful.

Examples

  f:=fval(" -12345 ");            ! Returns f = -12345.0

  f:=fval(" ABC ");               ! Returns 0.0

  f:=fval("1.2E3",status);        ! Retuns f = 1200.0 and status = 0

  f:=fval("ABC",status);          ! Returns f = 0.0 and status = -1

  f:=fval("1.2e-3 ABC",status,n); ! Returns f = 0.0012, status = 0 and n = 6

See also

ival(), rval() include(../../include/svnversion.inc) include(../../include/footer.inc)