Top Level

# RangeError - AS3

Package | Top Level
Class | public dynamic class RangeError
Inheritance | RangeError Error Object

Language Version: | ActionScript 3.0

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

A RangeError exception is thrown when a numeric value is outside the acceptable range. When working with arrays, referring to an index position of an array item that does not exist will throw a RangeError exception. Using `Number.toExponential()`, `Number.toPrecision()`, and `Number.toFixed()` methods will throw a RangeError exception in cases where the arguments are outside the acceptable range of numbers. You can extend `Number.toExponential()`, `Number.toPrecision()`, and `Number.toFixed()` to avoid throwing a RangeError.

Other situations that cause this exception to be thrown include the following:

- Any Flash runtime API that expects a depth number is invoked with an invalid depth number.
- Any Flash runtime API that expects a frame number is invoked with an invalid frame number.
- Any Flash runtime API that expects a layer number is invoked with an invalid layer number.

View the examples

More examples

Error handling in ActionScript 3.0
Responding to error events and status

Related API Elements

Number.toExponential()
Number.toPrecision()
Number.toFixed()

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
--- | --- | ---
|  | RangeError(message:String = "") Creates a new RangeError object. | RangeError
|  | 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

### RangeError

()
Constructor

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

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

Creates a new RangeError object.

Parameters

| `message:String` (default = "``")`` — Contains the message associated with the RangeError object.

More examples

Error handling in ActionScript 3.0
Responding to error events and status
Examples How to use this example
RangeErrorExample.as
The following example shows how a `RangeError` exception can be generated and handled within a `try..catch` statement.
Copy

    package {
        import flash.display.Sprite;

        public class RangeErrorExample extends Sprite {

            public function RangeErrorExample() {
                var child:Sprite = new Sprite();
                try {
                    addChildAt(child, 1);
                }
                catch(e:RangeError) {
                    trace(e);
                }
            }
        }
    }

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