Action |
SetOption can be used to configure certain options of the KiXtart script engine.
Syntax |
SETOPTION("option", "value")
Parameters |
Option
Option to set.
Value
Value for the option.
The options and possible values are described in the following table:
ASCII |
ON, OFF |
Default console output is in Unicode. Setting the ASCII option to ON changes the output to ASCII, so you can output extended characters, such as line characters. |
CaseSensitivity |
ON, OFF |
By default, all string comparisons are case-insensitive. Setting the CaseSensitivity option to ON configures KiXtart to make string comparisons case-sensitive. |
DisableDebugging |
ON |
Disables debugging (effectively disables the DEBUG ON command). Note that debugging can not be re-enabled. |
Explicit |
ON, OFF |
When you enable the Explicit option, you must explicitly declare all variables using the Dim, Global, or ReDim statements. If you attempt to use an undeclared variable name, an error occurs. Use the Explicit option to avoid incorrectly typing the name of an existing variable. |
HideCursor |
ON,OFF |
Hides or shows the console cursor. |
NoMacrosInStrings |
ON,OFF |
Determines resolution of macros inside strings. If this option is enabled, any ‘@’ character in a string will be left as-is. The default is OFF. |
NoVarsInStrings |
ON,OFF |
Determines resolution of variables inside strings. If this option is enabled, any ‘$’ character in a string will be left as-is. The default is OFF. |
WrapAtEOL |
ON,OFF |
Enables/disables wrapping of console output at the end of a line. The default is OFF. |
Returns |
SetOption returns the previous state of the option.
Example |
$previousstate = SetOption(
"ASCII", "ON" )
? "═══════════" ; output ASCII
line characters
$previousstate = SetOption(
"ASCII", $previousstate )