[转帖]Mootools源码分析-04 -- Array

//对数组的扩展实现
Array.implement({

    //迭代方法,call的使用
    forEach: function(fn, bind)    {
    for (var i =0, l =this.length; i < l; i++)    fn.call(bind, this[i], i, this);
    }
});

//将each作为forEach的别名
Array.alias('forEach', 'each');

//转为数组的快捷方式,但是在IE下,对于XML对象使用XPath查询后的结果,$A方法无法达到预期的结果
function $A(iterable)    {
    if (iterable.item)    { //对于collection,使用for遍历复制到数组
var array = [];
        for (var i =0, l = iterable.length; i < l; i++)    array[i] = iterable[i];
            return array;
    }

    //对于arguments和array对象,使用本方法可以转为数组
return Array.prototype.slice.call(iterable);
};

//通用迭代遍历方法
function $each(iterable, fn, bind)    {
    var type = $type(iterable);
    ((type =='arguments'|| type =='collection'|| type =='array') ? Array : Hash).each(iterable, fn, bind);
};


/*
对Array的扩展实现
对于迭代遍历时,给fn传递的参数依次为:当前数组项,当前项的索引值,当前数组对象,比如:
7前逢单7后双,判断月份大小的算法
function myfilter(item, i, arr){
var half = arr.length / 2 + 1;
return half > i && item % 2 || half <= i && !(item % 2);
}
[1,2,3,4,5,6,7,8,9,10,11,12].filter(myfilter);
上面的代码将返回[1, 3, 5, 7, 8, 10, 12]
然而,很多时候我们只需要使用第一个参数,即当前项的值
*/
Array.implement({

    //对数组的每一项使用一个逻辑判断,仅当所有项通过逻辑判断时返回true
    every: function(fn, bind)    {
        for (var i =0, l =this.length; i < l; i++)    {
            if (!fn.call(bind, this[i], i, this))    returnfalse;
        }
    returntrue;
    },

    //对数组进行逻辑过滤,返回包含所有通过逻辑判断的项的数组
    filter: function(fn, bind)    {
        var results = [];
        for (var i =0, l =this.length; i < l; i++)    {
            if (fn.call(bind, this[i], i, this))    results.push(this[i]);
        }
        return results;
    },

    //配合$defined和filter方法,清除数组中的空项/
    clean: function()    {
        returnthis.filter($defined);
    },

    /*
    类似String对象的indexOf方法,返回数组在指定位置开始查找指定的匹配项,并返回其索引值,没有找到时返回-1
    from参数可以在0和数组长度-1之间取值,也可以为负值,当为负值时表示开始查找的位置从后往前的位数
    */
    indexOf: function(item, from)    {
        var len =this.length;
        for (var i = (from <0) ? Math.max(0, len + from) : from ||0; i < len; i++)    {
            if (this[i] === item)    return i; //注意这里用的是绝对等于===比较
        }
        return-1;
    },

    //对数组中的每项进行处理,fn函数的返回值将代表原位置的项,最后返回一个经处理后的新数组
    map: function(fn, bind)    {
        var results = [];
        for (var i =0, l =this.length; i < l; i++)    results[i] = fn.call(bind, this[i], i, this);
        return results;
    },


    //与every方法相反,只需要数组中的有一项满足条件就返回true
    some: function(fn, bind)    {
        for (var i =0, l =this.length; i < l; i++)    {
            if (fn.call(bind, this[i], i, this))    returntrue;
        }
        returnfalse;
    },


    //将两个数组关联,组成键-值表示的对象,注意数组充当键还是值的决定因素--当前数组的每项作为值
    associate: function(keys    ){
        var ōbj = {}, length = Math.min(this.length, keys.length);
        for (var i =0; i < length; i++)    obj[keys[i]] =this[i];
        return obj;
    },

    //将数组的每项使用参数对象的方法进行处理,当返回true时当前项被添加到键值对象中作为值,处理的方法名作为键
    link: function(object)    {
        var result = {};
        for (var i =0, l =this.length; i < l; i++)    {
            for (var key in object)    {
                if (object[key](this[i]))    {
                    result[key] =this[i]; //键和值的关系
delete object[key]; //保证result中键不重复,数组中索引值越小优先级越高
break;
                }
            }
        }
        return result;
    },

    //利用index方法判断数组中是否包含指定项
    contains: function(item, from)    {
        returnthis.indexOf(item, from) !=-1;
    },

    //扩展数组,将指定数组加到当前数组后面
    extend: function(array){
        for (var i =0, j = array.length; i < j; i++)    this.push(array[i]);
        returnthis;
    },

    //获取数组的最后一项,只是一个快捷方式
    getLast: function()    {
        return (this.length) ?this[this.length -1] : null;
    },

    //随机获取数组的一项
    getRandom: function()    {
        return (this.length) ?this[$random(0, this.length -1)] : null;
    },


    //将指定项包含到数组,仅当数组中不存在该项时才会添加,通常用于不允许重复项的数组处理
    include: function(item)    {
        if (!this.contains(item))    this.push(item);
        returnthis;
    },

//合并数组,并且保证数组的项不重复
    combine: function(array)    {
        for (var i =0, l = array.length; i < l; i++)    this.include(array[i]);
        returnthis;
    },

    //在数组中删除指定项
    erase: function(item)    {
        for (var i =this.length; i--; i)    {
            if (this[i] === item)    this.splice(i, 1); //注意用的是===
        }
        returnthis;
    },

    //清空数组
    empty: function()    {
        this.length =0;
        returnthis;
    },

    /*
    将数组降维,即当数组中的项为数组时,将期拆开,按顺序加到新数组中
    这个在不能确定某个变量是数组还是单项时特别有用,比如说,我可以传[1,2,3],也可以传[1,[2,3]]
    */
    flatten: function()    {
        var array = [];
        for (var i =0, l =this.length; i < l; i++)    {
            var type = $type(this[i]);
            if (!type) continue;
            array = array.concat((type =='array'|| type =='collection'|| type =='arguments') ? Array.flatten(this[i]) : this[i]);
        }
        return array;
    },

    //颜色转换,从十六进制转为RGB表示
    hexToRgb: function(array)    {
        if (this.length !=3)    returnnull;
        var rgb =this.map(function(value)    {
            if (value.length ==1) value += value;
            return value.toInt(16);
        });
        return (array) ? rgb : 'rgb('+ rgb +')';
    },

    //颜色转换,从RGB转为十六进制表示
    rgbToHex: function(array)    {
        if (this.length <3)    returnnull;
        if (this.length ==4&&this[3] ==0&&!array) return'transparent';
        var hex = [];
        for (var i =0; i <3; i++)    {
                var bit = (this[i] -0).toString(16);
                hex.push((bit.length ==1) ?'0'+ bit : bit);
        }
        return (array) ? hex : '#'+ hex.join('');
    }
});