Subversion Repositories Applications.papyrus

if(!dojo._hasResource["dojo._base.array"]){ //_hasResource checks added by build. Do not use _hasResource directly in your code.
dojo._hasResource["dojo._base.array"] = true;
dojo.require("dojo._base.lang");
dojo.provide("dojo._base.array");

(function(){
        var _getParts = function(arr, obj, cb){
                return [ 
                        (dojo.isString(arr) ? arr.split("") : arr), 
                        (obj||dojo.global),
                        // FIXME: cache the anonymous functions we create here?
                        (dojo.isString(cb) ? (new Function("item", "index", "array", cb)) : cb)
                ];
        }

        dojo.mixin(dojo, {
                indexOf: function(      /*Array*/               array, 
                                                        /*Object*/              value,
                                                        /*Integer?*/    fromIndex,
                                                        /*Boolean?*/    findLast){
                        // summary:
                        //              locates the first index of the provided value in the
                        //              passed array. If the value is not found, -1 is returned.
                        // description:
                        //              For details on this method, see:
                        //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:indexOf

                        var i = 0, step = 1, end = array.length;
                        if(findLast){
                                i = end - 1;
                                step = end = -1;
                        }
                        for(i = fromIndex || i; i != end; i += step){
                                if(array[i] == value){ return i; }
                        }
                        return -1;      // Number
                },

                lastIndexOf: function(/*Array*/array, /*Object*/value, /*Integer?*/fromIndex){
                        // summary:
                        //              locates the last index of the provided value in the passed array. 
                        //              If the value is not found, -1 is returned.
                        // description:
                        //              For details on this method, see:
                        //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:lastIndexOf
                        return dojo.indexOf(array, value, fromIndex, true); // Number
                },

                forEach: function(/*Array*/arr, /*Function*/callback, /*Object?*/obj){
                        // summary:
                        //              for every item in arr, call callback with that item as its
                        //              only parameter.
                        // description:
                        //              Return values are ignored. This function
                        //              corresponds (and wraps) the JavaScript 1.6 forEach method. For
                        //              more details, see:
                        //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:forEach

                        // match the behavior of the built-in forEach WRT empty arrs
                        if(!arr || !arr.length){ return; }

                        // FIXME: there are several ways of handilng thisObject. Is
                        // dojo.global always the default context?
                        var _p = _getParts(arr, obj, callback); arr = _p[0];
                        for(var i=0,l=_p[0].length; i<l; i++){ 
                                _p[2].call(_p[1], arr[i], i, arr);
                        }
                },

                _everyOrSome: function(/*Boolean*/every, /*Array*/arr, /*Function*/callback, /*Object?*/obj){
                        var _p = _getParts(arr, obj, callback); arr = _p[0];
                        for(var i = 0, l = arr.length; i < l; i++){
                                var result = !!_p[2].call(_p[1], arr[i], i, arr);
                                if(every ^ result){
                                        return result; // Boolean
                                }
                        }
                        return every; // Boolean
                },

                every: function(/*Array*/arr, /*Function*/callback, /*Object?*/thisObject){
                        // summary:
                        //              Determines whether or not every item in the array satisfies the
                        //              condition implemented by callback.
                        // description:
                        //              The parameter thisObject may be used to
                        //              scope the call to callback. The function signature is derived
                        //              from the JavaScript 1.6 Array.every() function. More
                        //              information on this can be found here:
                        //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:every
                        // example:
                        //      |       dojo.every([1, 2, 3, 4], function(item){ return item>1; });
                        //              returns false
                        // example:
                        //      |       dojo.every([1, 2, 3, 4], function(item){ return item>0; });
                        //              returns true 
                        return this._everyOrSome(true, arr, callback, thisObject); // Boolean
                },

                some: function(/*Array*/arr, /*Function*/callback, /*Object?*/thisObject){
                        // summary:
                        //              Determines whether or not any item in the array satisfies the
                        //              condition implemented by callback.
                        // description:
                        //              The parameter thisObject may be used to
                        //              scope the call to callback. The function signature is derived
                        //              from the JavaScript 1.6 Array.some() function. More
                        //              information on this can be found here:
                        //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:some
                        // example:
                        //      |       dojo.some([1, 2, 3, 4], function(item){ return item>1; });
                        //              returns true
                        // example:
                        //      |       dojo.some([1, 2, 3, 4], function(item){ return item<1; });
                        //              returns false
                        return this._everyOrSome(false, arr, callback, thisObject); // Boolean
                },

                map: function(/*Array*/arr, /*Function*/func, /*Function?*/obj){
                        // summary:
                        //              applies a function to each element of an Array and creates
                        //              an Array with the results
                        // description:
                        //              Returns a new array constituted from the return values of
                        //              passing each element of arr into unary_func. The obj parameter
                        //              may be passed to enable the passed function to be called in
                        //              that scope.  In environments that support JavaScript 1.6, this
                        //              function is a passthrough to the built-in map() function
                        //              provided by Array instances. For details on this, see:
                        //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:map
                        // example:
                        //      |       dojo.map([1, 2, 3, 4], function(item){ return item+1 });
                        //              returns [2, 3, 4, 5]
                        var _p = _getParts(arr, obj, func); arr = _p[0];
                        var outArr = ((arguments[3]) ? (new arguments[3]()) : []);
                        for(var i=0;i<arr.length;++i){
                                outArr.push(_p[2].call(_p[1], arr[i], i, arr));
                        }
                        return outArr; // Array
                },

                filter: function(/*Array*/arr, /*Function*/callback, /*Object?*/obj){
                        // summary:
                        //              Returns a new Array with those items from arr that match the
                        //              condition implemented by callback. ob may be used to
                        //              scope the call to callback. The function signature is derived
                        //              from the JavaScript 1.6 Array.filter() function.
                        //
                        //              More information on the JS 1.6 API can be found here:
                        //                      http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:filter
                        // example:
                        //      |       dojo.filter([1, 2, 3, 4], function(item){ return item>1; });
                        //              returns [2, 3, 4]

                        var _p = _getParts(arr, obj, callback); arr = _p[0];
                        var outArr = [];
                        for(var i = 0; i < arr.length; i++){
                                if(_p[2].call(_p[1], arr[i], i, arr)){
                                        outArr.push(arr[i]);
                                }
                        }
                        return outArr; // Array
                }
        });
})();

}