This function will remove (free) the marker with the given ID, so the ID becomes available for reuse. Use this function on no longer needed markers.
If you otherwise just want to update the position of any existing marker, then you don't need to call this function, instead just call SetBufMark() on the existing marker again to set the new position.
SYNTAX:
err% = RemoveBufMark% (buf$(), markID%)
INPUTS:
buf$() (STRING array)
- This is the array of any existing and initialized buffer, from which you wanna remove the marker.
markID% (INTEGER)
- Any ID number in the range 1 to 100, which identifies the marker to remove.
- Accidental removal of already free (unused) markers won't hurt.
RESULT:
err% (INTEGER)
- This is usually zero (0) on success, or error SBE_BadIDNumber, if the given ID number was out of the valid range (see Common-Info).
- No other errors may happen, so if you make sure your used IDs are valid, then you may waive to explicit error checking.