This subroutine will write all data (referenced by the given memory block) into the specified buffer starting at the current buffer position. Hence, you can write anything, which can be accessed via a memory block, eg. single variables, entire arrays, array elements, user datatypes and even image data.
The call will also recalculate all markers to maintain its respective positions. The current buffer position is updated accordingly and is on the first byte behind the just written data after the call. Hence, sequential writing is easily possible with subsequent calls.
SYNTAX:
PutBufMemData buf$(), memData AS _MEM
INPUTS:
buf$() (STRING array)
- This is the array of any existing and initialized buffer, to which you wanna write to.
memData (_MEM block)
- The memory block, which its data shall be written into 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).