! statement The ! statement indicates that the text following the ! is a comment. This works the same as the remark statement.
* statement The * (asterisk) statement is used as a remark. Text after this statement is ignored.
$chain statement The $chain statement continues FlashBASIC or BASIC compilation in a different source item.
$include statement The $include statement inserts FlashBASIC or BASIC code from a separate item (known as an include item) to be compiled as part of the object module of the current program or subroutine. The original source program is not altered.
$options statement The $options statement sets compatibility options for the FlashBASIC or BASIC compiler.
abort statement The abort statement immediately stops program execution and unconditionally returns to the TCL command prompt.
aux statement The aux statement enables or disables spooling to the auxiliary port.
break statement The break statement enables or disables the BREAK key.
call statement The call statement transfers control to an external FlashBASIC or BASIC subroutine and optionally passes a list of arguments to it.
case statement The case statement delineates a conditional case construct.
casing statement The casing statement toggles case sensitivity relative to input data and string comparisons in the current program and any called subroutines.
cfunction statement The cfunction statement provides access to C libraries from BASIC.
chain statement The chain statement transfers processing control to TCL, which interprets and executes the statement defined in the expression.
clear statement The clear statement sets all local and common variables to 0 in a main program.
clearfile statement The clearfile statement deletes all items in the specified file variable previously opened with an open statement.
clearselect statement The clearselect statement clears the active select-list specified by the list.var and releases all overflow associated with that list. Any external select-list is also cleared if the list variable is not specified.
close statement The close statement closes the file identified by file.var. If file.var is not specified, the file referenced by the default file.var is closed.
common statement The common statement declares data elements to share among different FlashBASIC or BASIC modules.
compare statement The compare statement compares two dynamic arrays.
continue statement The continue statement restarts a loop that is under for...next or loop...repeat control.
convert statement The convert statement searches a given variable and replaces each occurrence of a character by another.
crt statement The crt statement outputs unconditionally to the terminal display, regardless of whether or not the printer on condition is in effect.
data statement The data statement queues responses for use by subsequent input requests initiated from chain, enter, execute, or input statements. The data is taken from the queue in the order in which it was added.
debug statement The debug statement temporarily suspends execution of a FlashBASIC or BASIC program and invokes the FlashBASIC or BASIC debugger.
del statement The del statement provides an alternate to the delete() function for deleting a location from a dynamic array.
delete statement The delete statement removes a specific item from a file.
dimension statement The dimension statement establishes a specific number of storage locations for a matrix of variables.
echo statement The echo statement toggles terminal echo on or off.
end statement The end statement indicates both the end of a series of statements executed conditionally from a then or else condition or the physical end of the program.
enter statement The enter statement transfers control to another cataloged FlashBASIC or BASIC program.
equate statement The equate statement is a compiler directive that declares a constant at compile time or a synonym of another variable or array element.
error statement The error statement displays the error message from the messages file and continues execution of the program.
execute statement The execute statement temporarily pushes a level and performs any valid TCL expression, then continues execution of the FlashBASIC or BASIC program.
execute statement (UNIX) The execute statement executes a UNIX command from within a FlashBASIC or BASIC program.
exit statement The exit statement forces an early exit from a loop that is under for...next or loop...repeat control.
file statement The file statement is a compiler directive that allows the use of attribute definition items in the file’s dictionary while compiling a program.
filelock statement The filelock statement sets an exclusive lock on an entire file.
fileunlock statement The fileunlock statement releases an exclusive lock set by the filelock statement on an entire file.
footing statement The footing statement designates a text string composed of literals and special options to output at the bottom of each page.
for...next statement The for...next statement is an iterative, incremental loop statement used to repeat a sequence of statements for a specific number of occurrences.
get statement The get statement gets raw characters from the specified port.
getx statement The getx statement receives input from an attached line in ASCII hexadecimal format. The statement returns an exploded ASCII hexadecimal string that allows binary data to contain a decimal 255 (x’ff’)
gosub statement The gosub statement transfers control to a local subroutine identified by a statement label within the program. Control returns to the next statement after the gosub statement when the return statement is encountered.
goto statement The goto statement transfers control to the location in the FlashBASIC or BASIC program that begins with the given statement label.
heading statement The heading statement designates a text string composed of literals and special options to output at the top of each page.
if statement The if statement tests the result of a logical expression. Depending on whether the expression evaluates to either true or false, the statements following the then or else clauses respectively are executed.
ifr statement The ifr statement tests the result of a logical expression.
in statement The in statement accepts a single raw character of input from the keyboard, without displaying a prompt character or requiring pressing ENTER following the input.
input statement The input statement temporarily suspends execution of the program until a response is provided from the keyboard and assigns that response to a specified variable.
inputclear statement The inputclear statement clears the keyboard type-ahead buffer.
inputctrl statement The inputctrl statement toggles on and off the ability to enter control characters on succeeding BASIC input statements.
inputerr statement The inputerr statement displays a message on the status (bottom) line of the terminal. it meant to be used with the input@ statement.
inputerr statement (Windows) When run from a trigger, from the D3 File Manager, or from a Visual Basic rule module, the inputerr statement displays a dialog box (allowing the user to specify the title, text, and buttons), then waits for input. Upon return, the system(0) function returns a numeric code indicating the user choice.
inputnull statement The inputnull statement is used with the input @ statement to define the character used to indicate a null input on subsequent input statements.
inputparity statement The inputparity statement enables or disables the extended character set (xcs) for the current process.
inputtrap...gosub statement The inputtrap...gosub statement, using the str.exp, sets up an automatic computed gosub based on the next input @ statement data. The position of the character in the string expression corresponds to the position of the statement label in the list. This acts as a trap that causes a gosub on all subsequent input @ statements.
inputtrap...goto statement The inputtrap...goto statement, using the str.exp, sets up an automatic computed goto based on the next input @ statement’s data. The position of each character in the string expression corresponds to the position of the statement label in the list. This acts as a trap that causes a goto on all subsequent input @ statements and branches to a label in the current program.
inputtrap off statement The inputtrap off statement cancels the previous inputtrap statement.
ins statement The ins statement is an alternative to the insert() function for inserting a string expression into a dynamic array.
key statement The key statement locates an item using a B-tree index key, and returns the item in a variable, providing the ability to sequentially search the items in the file based on the index.
let statement The let statement assigns the value of an expression to a variable.
locate statement The locate statement searches for the location of a specific string expression and returns the location in position.var.
lock statement The lock statement sets one of 992 execution locks, in the range from 0 through 63. This prevents re-entry to the program, allowing only one process to run the program at any given time.
loop statement The loop statement repetitively executes (loops) until an ending condition is met. The first set of statements, if present, is executed at least once.
mat statement The mat statement assigns data to each element of a dimensioned array variable to a specific value in one operation.
matbuild statement The matbuild statement converts a dimensioned array into a dynamic array.
matparse statement The matparse statement converts a dynamic array into a dimensioned array.
matread statement The matread statement reads the specified item from the optionally specified file.var, or if not specified, the default file.var, and stores one attribute per element in the dimensioned array.
matreadu statement The matreadu form of the matread statement tests if an item is already locked and locks the item if it is not. The item lock set by matreadu prevents the item from being read using the matreadu statement or updated by other processes while the lock is set.
matwrite statement The matwrite statement writes an item into the specified file.var.
matwriteu statement The matwriteu statement is identical to the matwrite statement, except the item remains locked. The matwriteu form keeps the item locked if it was previously locked by a readu, readvu, or matwriteu statement within the same program.
next statement The next statement occurs at the end of a for...next construct and causes the iteration counter to increment and branches to the corresponding for statement to decide whether to terminate.
null statement The null statement performs no operation, other than to provide an instruction where one is required. This is usually used for program readability.
on...gosub statement The on... gosub statement transfers control to a local subroutine designated by a specific statement label according to the positional value returned by the expression. The syntax can also be specified as on...go sub...(allowing a space between go and sub).
on...goto statement The on...goto statement transfers control to the line within the FlashBASIC or BASIC program that begins with the specified statement label, according to the positional value of the expression referenced by exp. The syntax can also be specified as on...go to...(allowing a space between go and to).
open statement The open statement opens a specified file name and associates the file with the optional file.var.
out statement The out statement outputs a single ASCII character derived from a numeric expression in the range of 0 through 255, which indicates its corresponding position in the ASCII table.
page statement The page statement terminates the current page of output, prints the optional footing, positions to the top of the form, and prints the optional heading.
precision statement The precision statement defines the number of fractional decimal places that a numerical value can hold.
print statement The print statement directs output of an expression to the current output device.
print on statement The print on statement directs output to one of 32,767 open print files.
printchar statement The printchar statement prints the first character of the string expression to the screen or to the printer.
printer statement The printer statement controls the output from subsequent print, heading, footing, or page statements.
procread statement The procread statement reads the calling Proc’s primary input buffer and assigns its contents to a specified variable.
procwrite statement The procwrite statement writes a string expression variable to the calling Proc’s primary input buffer.
program statement The program statement is optionally used on the first line of a program to indicate that this is a program.
prompt statement The prompt statement indicates the single character to display during subsequent input statements that prompt for input from the keyboard.
read statement The read statement reads an item as a dynamic array and stores the item as a string. Each attribute is automatically an element of the dynamic array variable and can be referenced with the appropriate intrinsic functions.
readnext statement The readnext statement retrieves the next item-ID from an active list and assigns it to a specified variable.
readt statement The readt statement reads a tape record and assigns the value returned to a specified variable.
readtx statement The readtx statement reads a tape record converts the tape record to hexadecimal and assigns the resulting hexadecimal value to a specified variable.
readv statement The readv statement reads an item from the optionally-specified file variable and assigns the value contained in the attribute number referenced in the attribute expression to the specified variable.
release statement The release statement clears locks on items locked with a previous matreadu, readu, or readvu statement.
rem statement The rem statement designates that all text that follows the statement on the same line is ignored by the compiler.
remove statement The remove statement retrieves a substring delimited by a system delimiter from a dynamic array.
repeat statement The repeat statement defines the end of a loop. See loop statement for more information.
replace statement The replace statement maintains referential integrity between items that contain bidirectional bridges used by the Update processor by eliminating duplicate item-IDs.
return statement The return statement terminates an internal or external subroutine and returns execution control to the statement following the invoking call or gosub statement.
rewind statement The rewind statement rewinds the currently attached magnetic tape unit to the beginning of the tape.
root statement The root statement provides an interface to the B-tree indexes for subsequent references with the key statement.
rqm statement The rqm statement suspends processing for a specific number of seconds, or until a specific time.
select statement The select statement creates an active list of item-IDs, allowing sequential access to each item in the file by use of the readnext statement.
send statement The send statement sends output to a specified port.
sendx statement The sendx statement converts the exploded ASCII hexadecimal string results of str.exp to its binary equivalent and then transmits it to the specified port. The conversion process terminates when the first nonhexadecimal character is encountered. sendx suppresses the output of a CR/LF pair. sendx does not allow the : to exist as part of the statement.
sleep statement The sleep statement places a process to sleep for a specific number of seconds, or, until a specific time.
spoolq statement The spoolq statement enables or disables the spooler entry number message.
stop statement The stop statement stops program execution and returns to the invoking the process.
subroutine statement The subroutine statement defines a program as an external subroutine.
ta statement The ta statement toggles or resets the type-ahead buffer.
tcl statement The tcl statement executes any valid TCL command as a subroutine.
tclread statement The tclread statement loads the TCL command used to activate the program into a variable.
transaction statement The transaction statement enables or disables participation in a transaction.
unlock statement The unlock statement resets an execution lock, in the range 0 to 991, previously set with a lock statement.
weof statement The weof statement writes an eof (end of file) mark to the currently attached magnetic media.
write statement The write statement writes the item specified in dyn.array.var into the specified file, using the item-ID specified in the ID.exp.
writet statement The writet statement writes a tape record to the attached magnetic media from the specified variable.
writeu statement The writeu form of the write statement writes a dynamic array into the specified file variable and keeps items locked that were locked by a previous readu or readvu statement.
writev statement The writev statement writes the value of an expression into the attribute designated in the attribute expression parameter, using the item-ID specified in ID.exp.
writevu statement The writevu form of this statement is identical to writev, except that the item remains locked.
writex statement The writex statement writes the item specified in dyn.array.var into the specified file, using the item-ID specified in the ID.exp. The writex statement will wait until the actual disk update takes place before continuing execution of the program. This is used for "critical" write-through, such as error-logging.