MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE - Tostring (Error.tostring Method)

548 ActionScript classes
Example
In the following example, a function throws a specified error depending on the two numbers
that you try to divide. Add the following ActionScript to Frame 1 of the Timeline:
function divideNumber(numerator:Number, denominator:Number):Number {
if (isNaN(numerator) || isNaN(denominator)) {
throw new Error("divideNum function requires two numeric parameters.");
} else if (denominator == 0) {
throw new DivideByZeroError();
}
return numerator/denominator;
}
try {
var theNum:Number = divideNumber(1, 0);
trace("SUCCESS! "+theNum);
// output: DivideByZeroError -> Unable to divide by zero.
} catch (e_err:DivideByZeroError) {
// divide by zero error occurred
trace(e_err.name+" -> "+e_err.toString());
} catch (e_err:Error) {
// generic error occurred
trace(e_err.name+" -> "+e_err.toString());
}
To add a custom error, add the following code to a .AS file called DivideByZeroError.as and
save the class file in the same directory as your FLA document.
class DivideByZeroError extends Error {
var name:String = "DivideByZeroError";
var message:String = "Unable to divide by zero.";
}
See also
throw statement, try..catch..finally statement
toString (Error.toString method)
public toString() : String
Returns the string "Error" by default or the value contained in Error.message, if defined.
Availability: ActionScript 1.0; Flash Player 7
Returns
String - A String