Package | flash.errors |
Class | public dynamic class StackOverflowError |
Inheritance | StackOverflowError Error Object |
Language Version: | ActionScript 3.0 |
Runtime Versions: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A StackOverflowError exception might indicate that infinite recursion has occurred, in which case a termination case needs to be added to the function. It also might indicate that the recursive algorithm has a proper terminating condition but has exhausted the stack anyway. In this case, try to express the algorithm iteratively instead.
More examples
Public Properties
Public Methods
Method | Defined By | ||
---|---|---|---|
StackOverflowError(message:String = "")
Creates a new StackOverflowError object. | StackOverflowError | ||
Returns the call stack for an error as a string at the time of the error's construction (for the debugger version
of Flash Player and the AIR Debug Launcher (ADL) only; returns null if not using the debugger version
of Flash Player or the ADL. | Error | ||
Indicates whether an object has a specified property defined. | Object | ||
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | ||
Indicates whether the specified property exists and is enumerable. | Object | ||
Sets the availability of a dynamic property for loop operations. | Object | ||
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | ||
[override]
Returns the string "Error" by default or the value contained in the Error.message property,
if defined. | Error | ||
Returns the primitive value of the specified object. | Object |
Constructor Detail
StackOverflowError | () | Constructor |
Examples How to use this example
StackOverflowErrorExample.as
The following example uses the sample StackOverflowErrorExample class to show
the error generated in the event of a stack overflow. This is accomplished using the following
steps:
- The constructor calls the method
lockMachine()
within an error handling code segment that catches StackOverflowError objects. - The
lockMachine()
method calls itself until the stack overflows. - After the StackOverflowError is thrown, the constructor catches it and then outputs an
error message through the
trace
statement.
package { import flash.display.Sprite; import flash.errors.StackOverflowError; public class StackOverflowErrorExample extends Sprite { public function StackOverflowErrorExample() { try { lockMachine(); } catch(e:StackOverflowError) { trace(e); // StackOverflowError: Error #1023: Stack overflow. } } private function lockMachine():void { lockMachine(); } } }
Mon Nov 28 2011, 06:48 AM -08:00