Packagesystem.numeric
Classpublic class Range
InheritanceRange Inheritance Object
Implements Equatable, Serializable

Represents an immutable range of values.

Example :

     import system.numeric.Range ;
     
     var r1:Range = new Range(10, 120) ;
     var r2:Range = new Range(100, 150) ;
     
     trace ("r1 : " + r1) ; // r1 : [Range$lt;10,120$gt;]
     trace ("r2 : " + r2) ; // r2 : [Range$lt;100,150$gt;]
     
     trace ("r2.toSource()     : " + r2.toSource()      ) ; // r2.toSource() : new system.numeric.Range(100,150)
     trace ("r1 contains 50    : " + r1.contains(50)    ) ; // r1 contains 50 : true
     trace ("r1 isOutOfRange 5 : " + r1.isOutOfRange(5) ) ; // r1 isOutOfRange 5 : true
     trace ("r1 overlap r2     : " + r1.overlap(r2)     ) ; // r1 overlap r2 : true
     trace ("r1 clamp 5        : " + r1.clamp(5)        ) ; // r1 clamp 5 : 10
     trace ("r1 clamp 121      : " + r1.clamp(121)      ) ; // r1 clamp 121 : 120
     



Public Properties
 PropertyDefined By
  max : Number
The max value of the range.
Range
  min : Number
The min value of the range.
Range
Public Methods
 MethodDefined By
  
Range(min:Number, max:Number)
Creates a new Range instance.
Range
  
clamp(value:Number):Number
Clamp a value in the current range.
Range
  
clone():*
Returns a shallow copy of the object.
Range
  
Creates a new range by combining two existing ranges.
Range
  
contains(value:Number):Boolean
Returns true if the Range instance contains the value passed in argument.
Range
  
equals(o:*):Boolean
Indicates whether some other object is "equal to" this one.
Range
  
expand(lowerMargin:Number = 1, upperMargin:Number = 1):Range
Creates a new range by adding margins to an existing range.
Range
  
filterNaNValue(value:Number, defaultValue:Number = 0):Number
[static] Filters the passed-in Number value, if the value is NaN the return value is the default value in second argument.
Range
  
Returns the central value for the range.
Range
  
Returns a random floating-point number between two numbers.
Range
  
Returns a random integer number between two numbers.
Range
  
isOutOfRange(value:Number):Boolean
Returns true if the value is out of the range.
Range
  
overlap(r:Range):Boolean
Returns true if the range in argument overlap the current range.
Range
  
size():Number
Returns the length of the range.
Range
  
toSource(indent:int = 0):String
Returns the source represensation of the object.
Range
  
toString():String
Returns the string representation of this instance.
Range
Public Constants
 ConstantDefined By
  COLOR : Range
[static] Range reference between -255 and 255.
Range
  DEGREE : Range
[static] Range reference between 0 and 360.
Range
  PERCENT : Range
[static] Range reference between 0 and 100.
Range
  UNITY : Range
[static] Range reference between 0 and 1.
Range
Property Detail
maxproperty
public var max:Number

The max value of the range.

minproperty 
public var min:Number

The min value of the range.

Constructor Detail
Range()Constructor
public function Range(min:Number, max:Number)

Creates a new Range instance.

Usage :

var r:Range = new Range( min:Number, max:Number) ;

Parameters
min:Number
 
max:Number
Method Detail
clamp()method
public function clamp(value:Number):Number

Clamp a value in the current range.

Parameters

value:Number

Returns
Number
clone()method 
public function clone():*

Returns a shallow copy of the object.

Returns
* — a shallow copy of the object.
combine()method 
public function combine(range:Range):Range

Creates a new range by combining two existing ranges.

Parameters

range:Range — the range to combine, null permitted.

Returns
Range
contains()method 
public function contains(value:Number):Boolean

Returns true if the Range instance contains the value passed in argument.

Parameters

value:Number

Returns
Booleantrue if the Range instance contains the value passed in argument.
equals()method 
public function equals(o:*):Boolean

Indicates whether some other object is "equal to" this one.

Parameters

o:*

Returns
Boolean
expand()method 
public function expand(lowerMargin:Number = 1, upperMargin:Number = 1):Range

Creates a new range by adding margins to an existing range.

Parameters

lowerMargin:Number (default = 1) — the lower margin (expressed as a percentage of the range length).
 
upperMargin:Number (default = 1) — the upper margin (expressed as a percentage of the range length).

Returns
Range — The expanded range.
filterNaNValue()method 
public static function filterNaNValue(value:Number, defaultValue:Number = 0):Number

Filters the passed-in Number value, if the value is NaN the return value is the default value in second argument.

Parameters

value:Number — The Number value to filter, if this value is NaN the value is changed.
 
defaultValue:Number (default = 0) — The default value to apply over the specified value if this value is NaN (default 0).

Returns
Number — The filter Number value.
getCentralValue()method 
public function getCentralValue():Number

Returns the central value for the range.

Returns
Number — The central value.
getRandomFloat()method 
public function getRandomFloat():Number

Returns a random floating-point number between two numbers.

Returns
Number — a random floating-point number between two numbers.
getRandomInteger()method 
public function getRandomInteger():int

Returns a random integer number between two numbers.

Returns
int — a random integer number between two numbers.
isOutOfRange()method 
public function isOutOfRange(value:Number):Boolean

Returns true if the value is out of the range.

Parameters

value:Number

Returns
Booleantrue if the value is out of the range.
overlap()method 
public function overlap(r:Range):Boolean

Returns true if the range in argument overlap the current range.

Parameters

r:Range

Returns
Booleantrue if the range in argument overlap the current range.
size()method 
public function size():Number

Returns the length of the range.

Returns
Number — the length of the range.
toSource()method 
public function toSource(indent:int = 0):String

Returns the source represensation of the object.

Parameters

indent:int (default = 0)

Returns
String — the source represensation of the object.
toString()method 
public function toString():String

Returns the string representation of this instance.

Returns
String — the string representation of this instance.
Constant Detail
COLORConstant
public static const COLOR:Range

Range reference between -255 and 255.

DEGREEConstant 
public static const DEGREE:Range

Range reference between 0 and 360.

PERCENTConstant 
public static const PERCENT:Range

Range reference between 0 and 100.

UNITYConstant 
public static const UNITY:Range

Range reference between 0 and 1.