PackageTop Level
Classpublic dynamic class RangeError
InheritanceRangeError Inheritance Error Inheritance Object

Language version: ActionScript 3.0
Runtime version: 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
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 at the time of the error's construction as a string.
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
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 version: AIR 1.0

Creates a new RangeError object.

Parameters
message:String (default = "") — Contains the message associated with the RangeError object.
Examples
examples\RangeErrorExample
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);
			}
		}
	}
}



Submit Feedback
© 2004-2022 Adobe Systems Incorporated. All rights reserved.
Wed Sep 28 2022, 6:12 PM GMT+01:00
Creative Commons License