references/sleep-functions/debug.md

GitHub

debug

Category: Utility

Source: https://sleep.dashnine.org/manual/debug.html


Synopsis

$ debug([level])

query/set the debug level for the current script environment.

Parameters

level - an integer specifying the current debug level. Debug levels can be OR'd together. The following debug levels can be combined with the OR operator i.e. 1 | 24:

LevelDescription 1display all hard errors as runtime warnings. 2display all soft errors as runtime warnings. These are the same errors that are caught programatically using &checkError 4display a runtime warning for the first time use of non-declared variables. 8trace all function calls (collects profiler statistics) 24trace function calls only for the purpose of collecting profiler statistics 34"throw" all errors flagged for use with &checkError 64trace all predicate decisions (follow program logic) 128trace propagation of tainted values

If no argument is specified then the current debug level is returned with no changes.

Returns

the current debug level

Examples

Example:

# query and print the current debug level

$level = debug();
println("The current debug level is $level");

# turn off all debug warnings

debug(0);

# enable all debug warnings

debug(7);

# enable debug options 1 and 4

debug(1 | 4);

# turn on debug option 4 (without affecting other options)

debug(debug() | 4);

# turn off debug option 4 (without affecting other options)

debug(debug() & not(4));

Output:

The current debug level is 1

See Also

&checkError; &getStackTrace; &profile; &taint; &watch; &warn