$R(start, end[, exclusive = false]) -> ObjectRange

Creates a new ObjectRange object. This method is a convenience wrapper around the ObjectRange constructor, but $R is the preferred alias.

ObjectRange instances represent a range of consecutive values, be they numerical, textual, or of another type that semantically supports value ranges. See the type’s documentation for further details, and to discover how your own objects can support value ranges.

The $R function takes exactly the same arguments as the original constructor: the lower and upper bounds (value of the same, proper type), and whether the upper bound is exclusive or not. By default, the upper bound is inclusive.


$R(0, 10).include(10)
// -> true

$A($R(0, 5)).join(', ')
// -> '0, 1, 2, 3, 4, 5'

$A($R('aa', 'ah')).join(', ')
// -> 'aa, ab, ac, ad, ae, af, ag, ah'

$R(0, 10, true).include(10)
// -> false

$R(0, 10, true).each(function(value) {
  // invoked 10 times for value = 0 to 9

Note that ObjectRange mixes in the Enumerable module: this makes it easy to convert a range to an Array (Enumerable provides the toArray method, which makes the $A conversion straightforward), or to iterate through values. (Note, however, that getting the bounds back will be more efficiently done using the start and end properties than calling the min() and max() methods).