This subroutine will write the given raw data as is into the specified buffer starting at the current buffer position. All control chars contained in the raw data are also written as is. The operation is in that very similar to PUT when writing to files.
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:
WriteBufRawData buf$(), rawData$
INPUTS:
buf$() (STRING array)
- This is the array of any existing and initialized buffer, to which you wanna write to.
rawData$ (STRING)
- The raw data to write into the buffer. You may add numbers either in its binary form using the various _MK$ functions or as text using STR$, HEX$ or OCT$, just as you need in your program.
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).