| 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
tracestatement.
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
Hide Inherited Public Properties
Show Inherited Public Properties