Description:
ERASE_LINE Deletes the current line from the current buffer. The deleted text
is returned as a string. Any markers positioned within the erased line are
moved to the first character position after the erased line. If the current window
position is mid-tab, past the end of the line, or past the end of the buffer,
ERASE_LINE will cause nu/TPU to insert padding spaces or lines. If the buffer
is mapped to a visible window, nu/TPU will force the editing position to match
the cursor position. If padding takes place, the inserted padding characters
will be deleted after the ERASE_LINE process, but they will be included in the
return value. Finally, if an error is signaled, zero length string is returned.
Syntax:
string := ERASE_LINE
Examples:
The following erases the current line from the current buffer.
ERASE_LINE (CURRENT_LINE);
The following erases the current line from the current buffer and places the
erased text in the variable var$1.
var$1 := ERASE_LINE;
Errors:
TPU$_NOCURRENTBUF Not in a buffer.
TPU$_NOTMODIFIABLE Current buffer is READ_ONLY.
Related Builtins:
ERASE_LINE