Retrieves data from an allocated memory block.
Usage
CALL "M$GET"
USING MEM-ADDRESS, DATA-ITEM,
DATA-SIZE, DATA-OFFSET
Parameters
MEM-ADDRESS USAGE POINTER
Must point to a memory area previously allocated by M$ALLOC.
DATA-ITEM Any data item
Data from the memory block will be stored in this item.
DATA-SIZE (optional) Numeric parameter
The number of bytes to move from the memory block. If omitted, then the number of bytes is set to the size of the memory block (excluding overhead bytes).
DATA-OFFSET (optional) Numeric parameter
The location within the memory block from which to start the move. The first location is position "1". If omitted, this value defaults to "1".
Description
This routine retrieves data from the memory block at MEM-ADDRESS and stores it in DATA-ITEM. Regardless of the value of DATA-SIZE, no bytes are copied from past the end of the memory block. Note that the size of DATA-ITEM is not checked.