PackageTop Level
Classpublic dynamic class RangeError
InheritanceRangeError Inheritance Error Inheritance Object

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 9, AIR 1.0

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:

View the examples

See also

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

Public Properties
 PropertyDefined By
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 InheritederrorID : int
[read-only] Contains the reference number associated with the specific error message.
Error
 Inheritedmessage : String
Contains the message associated with the Error object.
Error
 Inheritedname : String
Contains the name of the Error object.
Error
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
Public Methods
 MethodDefined By
  
RangeError(message:String = "")
Creates a new RangeError object.
RangeError
 Inherited
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 and the AIR Debug Launcher (ADL) only; returns null if not using the debugger version of Flash Player or the ADL.
Error
 Inherited
hasOwnProperty(name:String):Boolean
Indicates whether an object has a specified property defined.
Object
 Inherited
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
 Inherited
propertyIsEnumerable(name:String):Boolean
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
toLocaleString():String
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
toString():String
[override] Returns the string "Error" by default or the value contained in the Error.message property, if defined.
Error
 Inherited
valueOf():Object
Returns the primitive value of the specified object.
Object
Constructor Detail
RangeError()Constructor
public function RangeError(message:String = "")

Runtime Versions: AIR 1.0, Flash Player 9

Creates a new RangeError object.

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

See also

Number.toFixed()
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. 
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);
            }
        }
    }
}



© 2009 Adobe Systems Incorporated. All rights reserved.
Wed Jul 29 2009, 04:58 PM -07:00
RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError RangeError