B

Adds an entry to the breakpoint table.

Syntax

BvariableName operator operand {{& variableName operator operand} ...}

Syntax elements

variableName The name of a simple variable, an array, an array element, or the $ character to specify a line number.

If you specify the name of a dimensioned array but do not specify an element, the first element is used. However, it is recommended that, for clarity, you should always specify an element.

operator One of the following conditional operators:

= Equal to

# Not equal to

< Less than

> Greater than

<= Less than or equal to

>= Greater than or equal to

operand is the name of a variable, an array element, a string literal in single or double quotes or a numeric literal.

Operation

The clause variableName operator operand specifies a logical condition on which a break is to take place. Any number of these clauses can be combined in which case every clause must be satisfied for a break to occur.

You can use blanks freely or not at all.

Specifying line numbers

Enclosing a line number in brackets specifies that this is a source line number; that is, a line number in the source code. With no brackets, the line number refers to the combination of the source item with any included or chained items. Line numbers can also be specified as combinations of source item lines and included lines. Refer to the L command for full details and examples.

Note that the line so specified may be any line in the program, including any NULL statement, REM statement (or equivalent) or any complier directive (for example, an EQUATE statement).

Examples

*B INV(10)="BELLS" & COUNT > 12

A break occurs when the 10th element of dimension array INV is equal to the string literal BELLS and the value of variable COUNT is greater than 12.

*B ABLE < BAKER

A break occurs when the value of the variable ABLE is less than the value of the variable BAKER.

*B$ = 32

A break occurs when line 32 of the current program is the next to be executed.

*B$ >= 32

A break occurs on every line with number 32 or greater.