@BFREE — Releases a binary buffer.

Syntax:
%@BFREE[handle,flags]

handlea handle returned by @BALLOC
flags1: do not verify handle against list

This plugin replaces TCC’s internal @BFREE function to add one new feature:

  • If the handle is not found in this plugin’s list of binary buffers, @BFREE will fail with an error message. This safety feature prevents you from freeing anything other than binary buffers, or from freeing buffers which have already been freed. You can disable this check with the optional ,1 parameter; e.g. to free a buffer which was allocated before this plugin was loaded.

rem   Free the buffer named in BBUF:
set rv=%@bfree[%bbuf,1]

See also: @BALLOC, @BFREEALL.