execute-buffer(2)

NAME

execute-buffer - Execute script lines from a buffer
execute-line - Execute a script line from the command line

SYNOPSIS

n execute-buffer "buffer-name"
n execute-line ["command-line"]

DESCRIPTION

execute-buffer executes script lines in the named buffer buffer-name. If the buffer is off screen and an error occurs during execution, the cursor is left on the line causing the error.

If numeric argument n is given to execute-buffer then macro argument @?(4) will be set to 1 and @#(4) to n, otherwise @? and @# will be set to 0 and 1 respectively. These variables can be used by the macro code during the execution of the buffer.

execute-line executes a in script line entered from the command line, typically this command is used in macros. If bit 2 of the given numeric argument n is set then the command returns an error if there is more text given in the command-line than is executed, for example

3 execute-line "set-variable #g0 1 2" 

Will throw an error as " 2" is not used, this can be useful in tracking down macro errors. Note the @? and @# macro argument variables are also set.

SEE ALSO

execute-file(2), execute-string(2), execute-named-command(2).

(c) Copyright JASSPA 2025
Last Modified: 2022/06/12
Generated On: 2025/09/29