ActionScript 3.0 Language and Components Reference | All Packages | All Classes | Language Elements | Index | Appendixes | Conventions | Frames No Frames |
MemoryError

Package | flash.errors
Class | public dynamic class MemoryError
Inheritance | MemoryError Error Object

Language Version : | ActionScript 3.0

Player Version : | Flash Player 9

The MemoryError exception is thrown when a memory allocation request fails.

On a desktop machine, memory allocation failures are rare unless an allocation request is extremely large. For example, a 32-bit Windows program can access only 2GB of address space, so a request for 10 billion bytes is impossible.

By default, Flash Player does not impose a limit on how much memory an ActionScript program can allocate.

View the examples

See also

flash.error package Error classes

Public Properties
Hide Inherited Public Properties
Show Inherited Public Properties

| Property | Defined By
--- | --- | ---
|  | constructor : Object A reference to the class object or constructor function for a given object instance. | Object
|  | errorID : int [read-only] Contains the reference number associated with the specific error message. | Error
|  | message : String Contains the message associated with the Error object. | Error
|  | name : String Contains the name of the Error object. | Error
|  | prototype : Object [static] A reference to the prototype object of a class or function object. | Object

Public Methods
Hide Inherited Public Methods
Show Inherited Public Methods

| Method | Defined By
--- | --- | ---
|  | MemoryError(message:String = "") Creates a new MemoryError object. | MemoryError
|  | getStackTrace():String 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 only). | Error
|  | hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined. | Object
|  | isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter. | Object
|  | propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable. | Object
|  | setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations. | Object
|  | toString():String Returns the string "Error" by default or the value contained in Error.message property, if defined. | Error
|  | valueOf():Object Returns the primitive value of the specified object. | Object

Constructor Detail

MemoryError | () | Constructor

`public function MemoryError(message:String = "")`

Language Version : | ActionScript 3.0

Player Version : | Flash Player 9

Creates a new MemoryError object.

Parameters

| `message:String` (default = "``")`` — A string associated with the error object.

Examples How to use examples
MemoryErrorExample.as
The following example shows one method of generating a MemoryError.

    package {
        import flash.display.Sprite;
        import flash.errors.MemoryError;
        import flash.utils.setInterval;

        public class MemoryErrorExample extends Sprite {
            private var crashingStr:String;
            private var intervalId:Number;

            public function MemoryErrorExample() {
                crashingStr = "abcdefghijklmnopqrstuvwxyz";
                intervalId = setInterval(exhaustMemory, 50);
            }

            public function exhaustMemory():void {
                try {
                    crashingStr += crashingStr;
                }
                catch(e:MemoryError) {
                    trace(e);
                }
            }
        }
    }

Submit Feedback on LiveDocs
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Tue May 20 2008, 04:02 AM -07:00