1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-07-01 13:50:36 +00:00
QB64-PE/internal/help/FRE.txt
2017-10-10 11:55:21 -03:00

32 lines
1.5 KiB
Plaintext

'''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}}