flash.errors

# MemoryError - AS3

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

Language Version: | ActionScript 3.0

Runtime Versions: | AIR 1.0, Flash Player 9, Flash Lite 4

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

More examples

Comparing the Error classes
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

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 at the time of the error's construction as a string. | 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
|  | toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions. | Object
|  | toString():String [override] Returns the string "Error" by default or the value contained in the 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

Runtime Versions: | AIR 1.0, Flash Player 9

Creates a new MemoryError object.

Parameters

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

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

    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);
                }
            }
        }
    }

© 2015 Adobe Systems Incorporated. All rights reserved.
Mon Apr 10 2017, 12:28 PM -07:00