CALL FIND
This page was last modified 16:16, 3 August 2021 by Mars2000you.

Contents

Effect

Displays part of MSX-BASIC program that is in the computer memory, where a specified alphanumeric or strings variable is used.

It includes all the lines with visible appearance of this variable, but also the lines with DATA used for this variable.

Syntax

CALL FIND ("<Variable>",<StartLineNumber>,<EndLineNumber>,P)

The three last parameters are optional. Parameters can not end with a comma alone.

Parameters

<Variable> is used to specify a variable (maximum 2 characters). Without any other parameter, CALL FIND will scan the complete MSX-BASIC listing to display on the screen all the lines with using of this variable.

<StartLineNumber> specifies the number of the first line that needs to be checked for using of the specified variable. Without at least a comma (",") after this parameter, only this line will be checked.

<EndLineNumber> specifies the number of the last line that you want to be checked for using of the specified variable.

With the P parameter, the data will be sent to the printer.

Tip: To check only one line and send the data to the printer, you need to specify the same line both for <start line number> and <end line number>.

If you specify line numbers that don't exist, the computer will not display an error message, it will display the eventually existing lines between the specified start line and end line with using of the specified variable.

Examples

CALL FIND ("C1",,,P) ' Send to the printer all the lines with using of the variable C1
CALL FIND ("C1",1200) ' Check only line 1200 and eventually display it on the screen
CALL FIND ("C1",1200,1200,P) ' Check only line 1200 and eventually send it to the printer
CALL FIND ("C1",200,) ' Check listing between line 200 and final line for eventual display
CALL FIND ("C1",,200) ' Check listing until line 200 for eventual display
CALL FIND ("C1",50,200,P) ' Check the listing between lines 50 and 200 for eventual printing

Using

The execution of the instruction can be paused by pressing STOP. You can then resume it by pressing STOP again.

To completely stop the execution of this instruction, you need to press CTRL+STOP.

Related to

CALL VARLIST, CALL XREF

Compatibility

MSXAid BASIC