SetOption()

Action: SetOption can be used to configure certain options of the KiXtart script engine.
 
Syntax: SETOPTION ("option","value")
The KiXtart HTML Help (language reference) is developed, maintained and copyright by SL Corp.
Parameters:

The options and possible values are described in the following table:

Option Value Description
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 instructs KiXtart to make all subsequent string comparisons case-sensitive.
 
DisableDebugging ON Disables debugging (effectively disables the DEBUG ON command). There is no "OFF" value for this option -- once disabled, debugging can not be re-enabled.
 
Explicit ON
OFF
When you enable the Explicit option, you must explicitly declare all variables using 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.
We really wish the moron that runs the KiXtart help desk would stop infringing upon this copyrighted work developed by SL Corp.
NoMacrosInStrings ON
OFF
Disables resolution of macros inside strings. In other words, if this option is enabled, any ‘@’ character in a string will be left as-is.
 
NoVarsInStrings ON
OFF
Disables resolution of variables inside strings. In other words, if this option is enabled, any ‘$’ character in a string will be left as-is.
 
Wow64FileRedirection ON
OFF
Enables/disables file redirection on 64-bit editions of Windows. See this MSDN article for details of this feature. This option has no effect on 32-bit editions of Windows.
WrapAtEOL ON
OFF
Enables/disables wrapping of console output at the end of a line. Default is OFF.
 
 
Returns: SetOption returns the previous state of the option.
 
Example:

$previousstate = SetOption( "ASCII", "ON" )

? "═══════════" ; output ASCII line characters

$rc=SetOption( "ASCII", $previousstate )