Prototype ObjectRange对象学习_prototype

Ranges represent an interval of values. The value type just needs to be “compatible,” that is, to implement a succ method letting us step from one value to the next (its successor).

Prototype provides such a method for Number and String, but you are of course welcome to implement useful semantics in your own objects, in order to enable ranges based on them.

ObjectRange对象基本就是实现了连续的数字或者字符串，其中只包含一个方法，include，判断某个数字或者字符串是否在ObjectRange里。并且ObjectRange对象还混入了Enumerable的方法，所以可以直接在ObjectRange对象上调用Enumerable对象里面的方法。

//创建ObjectRange的便捷方法
function $R(start, end, exclusive) {
return new ObjectRange(start, end, exclusive);
}

//创建ObjectRange对象并且继承自Enumerable
var ObjectRange = Class.create(Enumerable, (function() {
//初始化方法，exclusive为true时，不包含end数值，默认为undefined也就相当于false
function initialize(start, end, exclusive) {
this.start = start;
this.end = end;
this.exclusive = exclusive;
}

//覆盖Enumerable里面的_each方法，在遍历ObjectRange对象时需要用到此方法
function _each(iterator) {
var value = this.start;
while (this.include(value)) {
iterator(value);
value = value.succ();
}
}

//判断某个数值或者字符串是否包含在ObjectRange对象里
function include(value) {
if (value return false;
if (this.exclusive)
return value return value }

return {
initialize: initialize,
_each: _each,
include: include
};
})());

看一下示例，然后在详细解释一些细节：

$A($R('a', 'e'))
// -> ['a', 'b', 'c', 'd', 'e'], no surprise there

//千万不要尝试输出下面返回的结果，否者将会造成浏览器直接死掉
$A($R('ax', 'ba'))
// -> Ouch! Humongous array, starting as ['ax', 'ay', 'az', 'a{', 'a|', 'a}', 'a~'...]

这里说一下$A($R('a', 'e'))，如何返回值。首先看$A方法，前面的文章【Prototype 学习——工具函数学习($A方法)】中已经详细讲解了$A方法，不知道请自行参考。在$A方法里面有这样一句：if ('toArray' in Object(iterable)) return iterable.toArray();我们知道，ObjectRange里面混入了Enumerable里面的方法，也就是说间接实现了toArray方法，那么看一下Enumerable里面的toArray方法：

function toArray() {
return this.map();
}

//======> this.map()

//我们注意到在返回的时候map方法被映射到了collect方法
return {
//...
collect: collect,
map: collect,
//...
}

//======> collect()

//在本例中这个方法其实就相当于返回一个数组，因为传进来的参数都是undefined。这里面有一个this.each方法，继续查看
function collect(iterator, context) {
iterator = iterator || Prototype.K;
var results = [];
this.each(function(value, index) {
results.push(iterator.call(context, value, index));
});
return results;
}

//======> this.each()

//终于看到this._each了，现在明白为什么ObjectRange里面会重写了_each方法了吧。在遍历的时候要用到这个方法
function each(iterator, context) {
var index = 0;
try {
this._each(function(value) {
iterator.call(context, value, index++);
});
} catch (e) {
if (e != $break) throw e;
}
return this;
}

//======> this._each()

//详细说明一下this._each()
//关键就是succ()这个方法，因为_each里面使用这个方法产生下一个数值。
//这个succ()在哪里呢？在Number.prototype和String.prototype里面定义了这个方法
function _each(iterator) {
var value = this.start;
while (this.include(value)) {
iterator(value);
value = value.succ();
}
}

//下面两个方法我就不讲了吧。

//======> String.prototype.succ()

function succ() {
return this.slice(0, this.length - 1) +
String.fromCharCode(this.charCodeAt(this.length - 1) + 1);
}

//======> Number.prototype.succ()

function succ() {
return this + 1;
}

//综上所述，如果你自己想定义其它类型的ObjectRange对象，譬如Date类型，那么你就要自己实现succ()方法，用来生成连续的对象

上面的流程将清楚了，但一些函数没有仔细讲，等讲到这些对象的时候在仔细说明里面的函数。下面看几个include的示例吧：

$R(1, 10).include(5)
// -> true
$R('a', 'h').include('x')
// -> false
$R(1, 10).include(10)
// -> true
$R(1, 10, true).include(10)
// -> false