This subroutine will fill the memory (referenced by the given memory block) with data from the buffer, ie. it reads data from the specified buffer starting at the current buffer position and copies the data to the referenced memory, continuing until the given memory block its size is filled. If the buffer has not sufficient data to fill the memory entirely, then the remaining bytes of the referenced memory remain undefined (probably garbage).
The current buffer position is updated accordingly and is on the first byte behind the just read data after the call. Hence, sequential reading is easily possible with subsequent calls. You may use EndOfBuf() to check, whether the buffer end is reached or not.
SYNTAX:
GetBufMemData buf$(), memData AS _MEM
INPUTS:
buf$() (STRING array)
- This is the array of any existing and initialized buffer, from which you wanna read.
memData (_MEM block)
- The memory block, which its referenced memory shall be filled with data from the buffer.
NOTES:
- If required, the following functions may be used to set the current buffer position in advance:
- SeekBuf() with an appropriate displacement and seek mode.
- GotoBufMark() to restore to an earlier marked position.
- FindBufFwd() or FindBufRev() to move to the next or previous occurrence of the designated find data (starting from the current position).