This function will copy the data block between the current buffer position and the given bound position to the clipboard and then delete the data block from the specified buffer. Apart from deleting the data block, this function is similar to CopyBufBlock(). The current buffer position is on the first byte behind the just cut out data block after the call.
SYNTAX:
err% = CutBufBlock% (buf$(), bound&)
INPUTS:
buf$() (STRING array)
- This is the array of any existing and initialized buffer, from which you wanna cut out the data.
bound& (LONG)
- This is the position of the opposite end of the data block to cut out (the 1st end is the current buffer position).
- The bound may be less than, equal to, or greater than the current position, although equal would result into copying & cutting nothing.
RESULT:
err% (INTEGER)
- This is usually zero (0) on success, or error SBE_OutOfBounds, if the given bound was out of the valid buffer data, which is 1 to GetBufLen() + 1 (see Common-Info).
- No other errors may happen, so if you make sure your bound position is valid, then you may waive to explicit error checking.