SETMEM Function Details
Syntax
SETMEM(numeric-expression)
The numeric-expression indicates the number of bytes to increase or
decrease the far heap.
- If the numeric-expression is negative, SETMEM decreases the far heap
by the indicated number of bytes.
- If the numeric-expression is positive, SETMEM attempts to increase
the far heap space by the number of bytes.
SETMEM returns the total number of bytes in the far heap. If the
numeric-expression is zero, SETMEM returns the current size of the far
heap.
If SETMEM cannot change the far heap by the requested number of bytes,
it reallocates as many bytes as possible.
SETMEM can be used in mixed-language programming to decrease the far
heap space so procedures in other languages can dynamically allocate
far memory.
Note: A first call to SETMEM trying to increase the far heap has no
effect because BASIC allocates as much memory as possible to
the far heap when a program starts.