RECHP

Syntax

RECHP address or

RECHP address1 *[,addressi]* (BTool only)

Location

Toolkit II, THOR XVI, BTool

The common heap is an area in memory where all programs may store data, this space being only limited by the memory available. A BASIC program can reserve space in the common heap with the function ALCHP.

The command RECHP allows you to recover this memory. The parameter of RECHP must be the address which was returned by ALCHP. The Btool variant of this command allows you to recover several addresses at once.

Example

Loading a title screen:

100 Title$="FLP1_TITLE_SCR"
110 IF FREE_MEM < 38*1024 THEN
120   LBYTES Title$,SCREEN
130 ELSE
140   TitleAdr=ALCHP(32768)
150   LBYTES Title$,TitleAdr
160   SCRBASE TitleAdr: REFRESH
170   RECHP TitleAdr
180 END IF

NOTE

RECHP reports error -15 if the address was not reserved with ALCHP or if the memory has already been given back to QDOS.

CROSS-REFERENCE

CLCHP clears all memory reserved by ALCHP, CLEAR deletes the values of all variables. See also DISCARD, TTREL and RELEASE.