LST

Convert Thoroughbred Basic Statement to List Format

This string function converts a compiled Thoroughbred Basic statement into its interpretive format.

Syntax

LST (string-value [,ERR=line-ref|,ERC=error-code])

string-value

is the compiled form of a single Thoroughbred Basic statement.

line-ref

is the program line number or label to branch to if an error is produced by this function.

error-code

is a programmer-defined error code. Valid values are positive or negative whole numbers.

Remarks

Although Thoroughbred Basic is an interpretive language, actual program statements are kept in memory and on storage media in a pseudo-compiled state. This allows Thoroughbred Basic to maintain programs in less space in memory and on storage media and to execute individual statements more quickly than if all statements were maintained in their fully expanded, LISTed form.

REM[ARKS] directives are maintained in their fully expanded format and are not compressed or compiled.

The reverse of this function is the CPL function; CPL(LST(string-value)) produces the string-value.

This function is not normally used within business applications, but is commonly found within system utilities, which manipulate program files. As such, it should not be used indiscriminately.

Examples

PRINT LST( PGM( 00100))

has the same effect as

LIST 00100

since the PGM(00100) function represents the compiled format of program line number 100.

PRINT LST( CPL( "100A=5"))

produces the fully expanded form of “100A=5” and result in

00100 LET A=5

See also

LIST directive
CPL, PFL, PFP, and PGM functions

From the Thoroughbred Basic Language Reference, Volume II: F–Q, version 8.9.1. Open this page in the PDF