Slverbosity

From OpenEUO
Jump to: navigation, search

Calling Convention

Call

local o = sl.slverbosity([flags])

Args

flags is a string, valid values: 'off', 'lo', 'med', 'hi'

Results

o is a string, the old value of flags

Usage Example

local sl = dofile(getinstalldir()..'/lib/simplelib.lua')
local o  = sl.slverbosity('hi')
print(o)
--> med

Description

Set the error and warning reporting verbosity level of the library if a flag argument is specified, and returns the old flags value regardless. Library initializes to 'med' verbosity. Valid flags:

flag  : effect
'off'   Turn error reporting completely off.
'lo'    Errors sent to file only, if redirection so allows.
'med'   Errors sent to file and or output window.
'hi'    Library will raise unhandled exception upon any error,
        stack trace added to error message if logged to file.

Additionally, if error reporting is set to 'hi' and errors are redirected to file, then a stack trace will be added to the logged error message.

Upon Error

Called with wrong arguments, slverbosity records the error and fails silently.

See Also