Contents Previous Next Subchapters

Set Printing and Tracing Options
Syntax setprint("continue", flag)
setprint("trace",    flag)
setprint("include",  flag)
See Also print

Description
This function controls some special printing and tracing options.

setprint("continue", 
flag)
If the logical scalar flag is true, each matrix is printed is such a way that a variable can be assigned to the matrix by copying it from the output window and pasting it to a file or the command line The default value for this setting is false.

setprint("trace", 
flag)
The value of a statement that consists of a single expression is printed unless it is equal to novalue . For example, if you enter
     1 + 2
O-Matrix will print the value
     3
If the logical scalar flag is true, the file and line number is printed next to the value of each expression statement that is printed. The default value for flag is false. This print option can help in locating expression statements that result in printed output.

setprint("include", 
flag)
Function and script files are often automatically included. If the logical scalar flag is true, a message is printed identifying what file was needed and where it was required.

Example

Trace
If the file TEMP.OMS contains the text
     1 + 2
and you enter
     include temp.oms
O-Matrix will reply
     3
If you then enter
     setprint("trace", true)
     include temp.oms
O-Matrix will reply
     expression statement: file C:\OMWIN\TEMP.OMS, line 1
     3

Continue
If you enter
     setprint("continue", true)
     print seq(3) * seq(3)'
O-Matrix will respond
     { ...
     [ 1 , 2 , 3 ], ...
     [ 2 , 4 , 6 ], ...
     [ 3 , 6 , 9 ]  ...
     }
Note that the continuation characters enable you to use this matrix as source code within an O-Matrix program. When using the continue option, character matrices will be surrounded by the " character when printed. If continue this example by entering
     print { "The quick brown fox", "jumped over the fence"}
O-Matrix will respond
     { ...
     "The quick brown fox", ...
     "jumped over the fence" ...
     }

Include
If you enter
     clear
     setprint("include", true)
     colsum( {1, 2, 3} )
O-Matrix will respond
     Automatic include of C:\OMWIN\FUNCTION\COLSUM.OMS
     required at line 5 in command line
     6
The value six is equal to one plus two plus three. The value 5 may be different depending on the number of commands entered before this example.