Description:
ERASE removes the specified text. ERASE does not delete references to the
structure in which the text being erased resides, only the text associated with
the structure. Space that was used by the text is freed. Note that text does is
not part of the range structure. Erasing with a range argument allows for
portions of a buffer to be removed. The buffer's associate insert and overstrike
modes have no effect on how ERASE functions. All ranges and markers contained in
the erased text are moved to character position after the erased text.
Syntax:
ERASE ( { buffer | range } )
Example:
The following tells nu/TPU to erase all text in the current buffer (using the
nu/TPU CURRENT_BUFFER built-in).
ERASE (CURRENT_BUFFER);
Errors:
TPU$_NOCURRENTBUF Not in a buffer.
TPU$_NOTMODIFIABLE Current buffer is READ_ONLY.
Related Builtins:
ERASE