This subroutine will insert the entire regular contents of the given source buffer into the specified destination buffer starting at the current buffer (cursor) position of the destination buffer. Any set markers and find data are not part of the regular data, hence they are not transferred over to the destination buffer.
The call will also recalculate all markers of the specified destination buffer to maintain its respective positions. The current buffer position is updated accordingly and is on the first byte behind the inserted data after the call.
The source buffer itself remains completely unchanged and in same state regarding the current buffer position, markers, find data and active line endings logic, hence you can simply go on working with the source buffer.
SYNTAX:
BufInsertBuf buf$(), fromBuf$()
INPUTS:
buf$() (STRING array)
- This is the array of any existing and initialized buffer, in which you want to insert the data (destination buffer).
fromBuf$() (STRING array)
- This is the array of another existing and initialized buffer, from which you wanna take the data (source buffer).
NOTES:
- If you've inserted pure text from a buffer with a different line endings logic than your given destination buffer, then you may want to call the appropriate conversion subroutine ConvBufToNativeEol(), ConvBufToWinEol() or ConvBufToLnxMacEol() right after inserting the text to bring all data in line with your destination buffer's line endings again.