@BALLOC — Allocates a new binary
buffer.
Syntax:
%@BALLOC[size]
| size | the size of the new buffer; required |
@BALLOC returns a handle to the new buffer, which you will use
in subsequent buffer operations.
This plugin replaces TCC’s internal @BALLOC function to
add two new features:
• The handle it returns will be remembered
for later use. You can use BBLIST to list
all currently allocated binary buffers, and @BFREEALL
to free them all at once.
• The size may optionally be followed by a letter to indicate scale. Note that case is significant:
k | thousands of bytes |
K | kilobytes (1,024 bytes) |
m | millions of bytes |
M | megabytes (1,048,576 bytes) |
g | billions of bytes |
G | gigabytes (1,073,741,824 bytes) |
rem Allocate a 5-kilobyte buffer:
set bbuf=%@balloc[5K]