This function will remove (free) the find data with the given ID, so the ID becomes available for reuse. Use this function on no longer needed find data.
If you otherwise just want to update any existing find data with new search criteria, then you don't need to call this function, instead just call SetBufFind() on the existing find data again to set the new criteria.
SYNTAX:
err% = RemoveBufFind% (buf$(), findID%)
INPUTS:
buf$() (STRING array)
- This is the array of any existing and initialized buffer, from which you wanna remove the find data.
findID% (INTEGER)
- Any ID number in the range 1 to 100, which identifies the find data to remove.
- Accidental removal of already free (unused) find data 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.