Changing Default Error Reporting Mode - Revision history

Ximan: /* See Also */

2010-11-02T16:24:59Z

‎See Also

Ximan: /* Inline */

2010-11-02T05:37:38Z

‎Inline

Ximan at 02:33, 2 November 2010

2010-11-02T02:33:13Z

Ximan: Created page with "By default, every error (whether or not fatal) detected by the library at run time is logged into an internal error table and an error message is generated for the user. There a..."

2010-11-02T02:31:52Z

Created page with "By default, every error (whether or not fatal) detected by the library at run time is logged into an internal error table and an error message is generated for the user. There a..."

New page

By default, every error (whether or not fatal) detected by the library at run time is logged into an internal error table and an error message is generated for the user. There are two non-exclusive manners for reporting errors: printing to the script's output window and logging to an error file. Either can be toggled on or off separately (see [[slredirect]]) and the manner of reporting may additionally be influenced by the error verbosity level (see [[slverbosity]]).

After a detected error is recorded, then one of three modes of error handling is invoked: reraise (the default), inline, or callback. The error handling mode may be switched using the [[slredirect]] method.

== Reraise ==

Upon library initialization, the default error handling procedure is to reraise any encountered error, whether the underlying error is fatal or not.

== Inline ==

To allow more fluid operation, detected errors may be handled by the library and the usual results of a function in an error condition is supplanted with an error result [[tuple]] ([[ERR]],eref), where [[ERR]] is a unique library defined value, and eref is a number which can be used as an argument to [[geterror]] to retrieve the recorded error table. Alternatively, the error result be set to return (nil, eref) a more standard lua form.

== Callback ==

The final error handling mode allows the user to specify a callback function. If specified and enabled, this callback will be invoked after the error is recorded, and the result of the callback function supplants the usual return values of the function at error.

← Older revision		Revision as of 16:24, 2 November 2010
Line 16:		Line 16:

	== See Also ==		== See Also ==
		+
		+	* [http://www.easyuo.com/openeuo/wiki/index.php/Simplelib simplelib]

	* [[geterror]]		* [[geterror]]

← Older revision		Revision as of 02:33, 2 November 2010
Line 14:		Line 14:

	The final error handling mode allows the user to specify a callback function. If specified and enabled, this callback will be invoked after the error is recorded, and the result of the callback function supplants the usual return values of the function at error.		The final error handling mode allows the user to specify a callback function. If specified and enabled, this callback will be invoked after the error is recorded, and the result of the callback function supplants the usual return values of the function at error.
		+
		+	== See Also ==
		+
		+	* [[geterror]]
		+
		+	* [[slredirect]]
		+
		+	* [[slverbosity]]
		+
		+	* [[try]]
		+
		+	* [[ERR]]

@@ Line 9: / Line 9: @@
 == Inline ==
-To allow more fluid operation, detected errors may be handled by the library and the usual results of a function in an error condition is supplanted with an error result [[tuple]] ([[ERR]],eref), where [[ERR]] is a unique library defined value, and eref is a number which can be used as an argument to [[geterror]] to retrieve the recorded error table.  Alternatively, the error result be set to return (nil, eref) a more standard lua form.
+To allow more fluid operation, detected errors may be handled by the library and the usual results of a function in an error condition is supplanted with an error result [[tuple]] ([[ERR]],eref), where [[ERR]] is a unique library defined value, and eref is a number which can be used as an argument to [[geterror]] to retrieve the recorded error table.  Alternatively, the error result be set to return ([[nil]], eref) a more standard lua form.
 == Callback ==