<HEAD> <TITLE> error_handler - function in master object to handle errors </TITLE> </HEAD> <BODY BACKGROUND=http://www.imaginary.com/~beek/gifs/bg.jpg TEXT=#000000 ALINK=#FFFF00 VLINK=#550000 LINK=#000099> <center> <H1> error_handler - function in master object to handle errors </H1> </center>
<p>
<b> void error_handler( mapping error, int caught ); </b>
<p>
This function is only called if MUDLIB_ERROR_HANDLER is defined.
<p>
This function allows the mudlib to handle <i> runtime </i> errors.
The contents of the 'error' mapping are:
<pre>
([
"error" : string, // the error
"program" : string, // the program
"object" : object, // the current object
"line" : int, // the line number
"trace" : mapping array // a trace back
])
</pre>
Each line of traceback is a mapping containing the following:
<pre>
([
"function" : string, // the function name
"program" : string, // the program
"object" : object, // the object
"file" : string, // the file to which the line number refers
"line" : int, // the line number
"arguments" : array, // function arguments
"locals" : array // local variables
])
</pre>
<p>
arguments and local variables are only available if ARGUMENTS_IN_TRACEBACK
and LOCALS_IN_TRACEBACK are defined.
<p>
The 'caught' flag is 1 if the error was trapped by catch().
<p>
See also:
<A HREF=../../efuns/calls/catch.html> catch </A>,
<A HREF=../../efuns/system/error.html> error </A>,
<A HREF=../../efuns/calls/throw.html> throw </A>,
<A HREF=log_error.html> log_error </A>
<p>
<HR> <ADDRESS> <A HREF=http://wagner.princeton.edu/~tim> Tim Hollebeek </A> <p> <A HREF="http://www.imaginary.com/~beek/"> Beek </A>@ZorkMUD, Lima Bean, IdeaExchange, TMI-2, and elsewhere </ADDRESS>