qb45advr.hlp (Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
FRE Function Details
  QuickSCREEN      Details      Example      Contents      Index
──────────────────────────────────────────────────────────────────────────────
FRE Function Details
 
Syntax
  FRE(stringexpression)
  FRE(numeric-expression)
 
The FRE function returns the following values when it has a numeric
argument (numeric-expression):
 
  Argument        Value Returned
  -1              The size, in bytes, of the largest nonstring
                  array that could be dimensioned
  -2              The amount, in bytes, of unused stack space
                  available to the program
  Any other       The size of the next free block of string
  numeric value   storage
 
When the argument is a string expression (stringexpression), FRE returns the
size, in bytes, of the free string storage. Before FRE returns the number of
free bytes, it compacts the free string storage into a single block.
 
  Note: FRE(-2) returns meaningful values only when a program is
        executing. Values returned by FRE(-2) are not accurate when
        the function is called from the Immediate window, during
        program tracing, or when watching a variable.