qb64/internal/help/FRE.txt

'''This page is maintained for historic purposes. The keyword is [[Keywords currently not supported by QB64|not supported in QB64]].'''
----
The [[FRE]] function returns the amount of memory available in bytes to running programs.


{{PageSyntax}}
: {{Parameter|memory}} = [[FRE]]({{Parameter|stringExpression$}})
: {{Parameter|memory}} = [[FRE]]({{Parameter|numericalExpression}})


{{PageDescription}}
*'''[[Keywords currently not supported by QB64|Not supported in QB64.]]'''
* Any {{Parameter|stringExpression$}} returns the size, in bytes, of free string storage space.
** Also compacts the free string storage to a single block of memory.
* {{Parameter|numericalExpression}} can be:
**  0: returns the same value as using a string expression above.
** -1: returns the size of the largest non-string array in bytes that could be dimensioned.
** -2: returns the amount of stack space, in bytes, available to a running program. 
** Any other numerical value returns the size of the next block of string memory storage space.


{{PageExamples}}
{{CodeStart}} '' ''
' {{Cl|$DYNAMIC}}
PRINT "Sizes in bytes before dimensioning arrays:  "; {{Cl|FRE}}(""), {{Cl|FRE}}(0), {{Cl|FRE}}(-1), {{Cl|FRE}}(-2)
{{Cl|DIM}} Array(100, 100), Text$(5000)
PRINT "Sizes in bytes after dimensioning arrays:   "; {{Cl|FRE}}(""), {{Cl|FRE}}(0), {{Cl|FRE}}(-1), {{Cl|FRE}} (-2) '' ''
{{CodeEnd}}
''Notes:'' Sizes returned may vary by computer used. FRE(-2) must be used in a running program.


{{PageNavigation}}