CALL "M$GET" USING MEM-ADDRESS, DATA-ITEM, DATA-SIZE, DATA-OFFSET
|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 Numeric parameter (optional)||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 Numeric parameter (optional)||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.|
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.