NotRun {brassica}

Check BASIC Programs

Description

Returns a data frame of any BASIC program lines that contain one or more unexecuted statements. Used with repeated calls of RUN(), this provides a test of code syntax and accessibility.

Usage

NotRun(pretty = TRUE)

Arguments

pretty

A single logical value. If TRUE (the default), formatted output is printed before the data frame is returned invisibly. If FALSE, the data frame is returned normally (visibly), without any other output being printed.

Value

Returns a data frame of any lines, from the currently-loaded BASIC program, containing one or more unexecuted statements. Lines are listed with both their BASIC line numbers and the corresponding file line numbers of the source script. A persistent appearance here may, but does not necessarily, signify a problem with the line.

Note

BASIC ON and IF-THEN-ELSE statements contain multiple alternative clauses. Each such statement, as a whole, is marked as having been executed once any one of its clauses has been run without error. Hence, the absence of such a statement from the NotRun() frame does not guarantee that all of its clauses are error-free.

See Also

RUN

Examples

# Peruse which lines have not yet been run.
NotRun()