Mirrors/lodash
1
0
Fork 0
mirror of https://github.com/whoisclebs/lodash.git synced 2026-02-08 10:17:48 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add creator functions.

Browse Source
This commit is contained in:
jdalton
2015-03-15 14:48:32 -07:00
parent d4659b261d
commit 306ef8addf
1 changed files with 130 additions and 136 deletions
Download Patch File Download Diff File Expand all files Collapse all files

266
lodash.src.js
View File

@@ -2185,20 +2185,7 @@
* @param {Function} keysFunc The function to get the keys of `object`. * @param {Function} keysFunc The function to get the keys of `object`.
* @returns {Object} Returns `object`. * @returns {Object} Returns `object`.
*/ */
function baseFor(object, iteratee, keysFunc) { var baseFor = createBaseFor();
var index = -1,
iterable = toObject(object),
props = keysFunc(object),
length = props.length;
while (++index < length) {
var key = props[index];
if (iteratee(iterable[key], key, iterable) === false) {
break;
}
}
return object;
}
/** /**
* This function is like `baseFor` except that it iterates over properties * This function is like `baseFor` except that it iterates over properties
@@ -2210,19 +2197,7 @@
* @param {Function} keysFunc The function to get the keys of `object`. * @param {Function} keysFunc The function to get the keys of `object`.
* @returns {Object} Returns `object`. * @returns {Object} Returns `object`.
*/ */
function baseForRight(object, iteratee, keysFunc) { var baseForRight = createBaseFor(true);
var iterable = toObject(object),
props = keysFunc(object),
length = props.length;
while (length--) {
var key = props[length];
if (iteratee(iterable[key], key, iterable) === false) {
break;
}
}
return object;
}
/** /**
* The base implementation of `_.forIn` without support for callback * The base implementation of `_.forIn` without support for callback
@@ -3151,6 +3126,23 @@
}; };
} }
function createBaseFor(fromRight) {
return function(object, iteratee, keysFunc) {
var iterable = toObject(object),
props = keysFunc(object),
length = props.length,
index = fromRight ? length : -1;
while ((fromRight ? index-- : ++index < length)) {
var key = props[index];
if (iteratee(iterable[key], key, iterable) === false) {
break;
}
}
return object;
};
}
/** /**
* Creates a function that wraps `func` and invokes it with the `this` * Creates a function that wraps `func` and invokes it with the `this`
* binding of `thisArg`. * binding of `thisArg`.
@@ -3257,6 +3249,18 @@
}; };
} }
function createCurry(curryFlag) {
function curryFunc(func, arity, guard) {
if (guard && isIterateeCall(func, arity, guard)) {
arity = null;
}
var result = createWrapper(func, curryFlag, null, null, null, null, null, arity);
result.placeholder = curryFunc.placeholder;
return result;
}
return curryFunc;
}
/** /**
* Creates a function that gets the extremum value of a collection. * Creates a function that gets the extremum value of a collection.
* *
@@ -3290,6 +3294,84 @@
}; };
} }
function createFind(eachFunc, fromRight) {
return function(collection, predicate, thisArg) {
predicate = getCallback(predicate, thisArg, 3);
if (isArray(collection)) {
var index = baseFindIndex(collection, predicate, fromRight);
return index > -1 ? collection[index] : undefined;
}
return baseFind(collection, predicate, eachFunc);
}
}
function createFindIndex(fromRight) {
return function(array, predicate, thisArg) {
if (!(array && array.length)) {
return -1;
}
predicate = getCallback(predicate, thisArg, 3);
return baseFindIndex(array, predicate, fromRight);
};
}
function createFindKey(eachFunc) {
return function(object, predicate, thisArg) {
predicate = getCallback(predicate, thisArg, 3);
return baseFind(object, predicate, eachFunc, true);
};
}
function createForOwn(eachFunc) {
return function(object, iteratee, thisArg) {
if (typeof iteratee != 'function' || typeof thisArg != 'undefined') {
iteratee = bindCallback(iteratee, thisArg, 3);
}
return eachFunc(object, iteratee);
};
}
function createForEach(arrayFunc, baseFunc) {
return function(collection, iteratee, thisArg) {
return (typeof iteratee == 'function' && typeof thisArg == 'undefined' && isArray(collection))
? arrayFunc(collection, iteratee)
: baseFunc(collection, bindCallback(iteratee, thisArg, 3));
};
}
function createForIn(baseFunc) {
return function(object, iteratee, thisArg) {
if (typeof iteratee != 'function' || typeof thisArg != 'undefined') {
iteratee = bindCallback(iteratee, thisArg, 3);
}
return baseFunc(object, iteratee, keysIn);
};
}
function createPadDir(fromRight) {
return function(string, length, chars) {
string = baseToString(string);
return string && ((fromRight ? string : '') + createPad(string, length, chars) + (fromRight ? '' : string));
};
}
function createPartial(partialFlag) {
var partialFunc = restParam(function(func, partials) {
var holders = replaceHolders(partials, partialFunc.placeholder);
return createWrapper(func, partialFlag, null, partials, holders);
});
return partialFunc;
}
function createReduce(arrayFunc, eachFunc) {
return function(collection, iteratee, accumulator, thisArg) {
var initFromArray = arguments.length < 3;
return (typeof iteratee == 'function' && typeof thisArg == 'undefined' && isArray(collection))
? arrayFunc(collection, iteratee, accumulator, initFromArray)
: baseReduce(collection, getCallback(iteratee, thisArg, 4), accumulator, initFromArray, eachFunc);
};
}
/** /**
* Creates a function that wraps `func` and invokes it with optional `this` * Creates a function that wraps `func` and invokes it with optional `this`
* binding of, partial application, and currying. * binding of, partial application, and currying.
@@ -4583,13 +4665,7 @@
* _.findIndex(users, 'active'); * _.findIndex(users, 'active');
* // => 2 * // => 2
*/ */
function findIndex(array, predicate, thisArg) { var findIndex = createFindIndex();
if (!(array && array.length)) {
return -1;
}
predicate = getCallback(predicate, thisArg, 3);
return baseFindIndex(array, predicate);
}
/** /**
* This method is like `_.findIndex` except that it iterates over elements * This method is like `_.findIndex` except that it iterates over elements
@@ -4639,13 +4715,7 @@
* _.findLastIndex(users, 'active'); * _.findLastIndex(users, 'active');
* // => 0 * // => 0
*/ */
function findLastIndex(array, predicate, thisArg) { var findLastIndex = createFindIndex(true);
if (!(array && array.length)) {
return -1;
}
predicate = getCallback(predicate, thisArg, 3);
return baseFindIndex(array, predicate, true);
}
/** /**
* Gets the first element of `array`. * Gets the first element of `array`.
@@ -6098,14 +6168,7 @@
* _.result(_.find(users, 'active'), 'user'); * _.result(_.find(users, 'active'), 'user');
* // => 'barney' * // => 'barney'
*/ */
function find(collection, predicate, thisArg) { var find = createFind(baseEach);
predicate = getCallback(predicate, thisArg, 3);
if (isArray(collection)) {
var index = baseFindIndex(collection, predicate);
return index > -1 ? collection[index] : undefined;
}
return baseFind(collection, predicate, baseEach);
}
/** /**
* This method is like `_.find` except that it iterates over elements of * This method is like `_.find` except that it iterates over elements of
@@ -6126,10 +6189,7 @@
* }); * });
* // => 3 * // => 3
*/ */
function findLast(collection, predicate, thisArg) { var findLast = createFind(baseEachRight, true);
predicate = getCallback(predicate, thisArg, 3);
return baseFind(collection, predicate, baseEachRight);
}
/** /**
* Performs a deep comparison between each element in `collection` and the * Performs a deep comparison between each element in `collection` and the
@@ -6194,11 +6254,7 @@
* }); * });
* // => logs each value-key pair and returns the object (iteration order is not guaranteed) * // => logs each value-key pair and returns the object (iteration order is not guaranteed)
*/ */
function forEach(collection, iteratee, thisArg) { var forEach = createForEach(arrayEach, baseEach);
return (typeof iteratee == 'function' && typeof thisArg == 'undefined' && isArray(collection))
? arrayEach(collection, iteratee)
: baseEach(collection, bindCallback(iteratee, thisArg, 3));
}
/** /**
* This method is like `_.forEach` except that it iterates over elements of * This method is like `_.forEach` except that it iterates over elements of
@@ -6219,11 +6275,7 @@
* }).join(','); * }).join(',');
* // => logs each value from right to left and returns the array * // => logs each value from right to left and returns the array
*/ */
function forEachRight(collection, iteratee, thisArg) { var forEachRight = createForEach(arrayEachRight, baseEachRight);
return (typeof iteratee == 'function' && typeof thisArg == 'undefined' && isArray(collection))
? arrayEachRight(collection, iteratee)
: baseEachRight(collection, bindCallback(iteratee, thisArg, 3));
}
/** /**
* Creates an object composed of keys generated from the results of running * Creates an object composed of keys generated from the results of running
@@ -6600,12 +6652,7 @@
* }, {}); * }, {});
* // => { 'a': 3, 'b': 6 } (iteration order is not guaranteed) * // => { 'a': 3, 'b': 6 } (iteration order is not guaranteed)
*/ */
function reduce(collection, iteratee, accumulator, thisArg) { var reduce = createReduce(arrayReduce, baseEach);
var initFromArray = arguments.length < 3;
return (typeof iteratee == 'function' && typeof thisArg == 'undefined' && isArray(collection))
? arrayReduce(collection, iteratee, accumulator, initFromArray)
: baseReduce(collection, getCallback(iteratee, thisArg, 4), accumulator, initFromArray, baseEach);
}
/** /**
* This method is like `_.reduce` except that it iterates over elements of * This method is like `_.reduce` except that it iterates over elements of
@@ -6629,12 +6676,7 @@
* }, []); * }, []);
* // => [4, 5, 2, 3, 0, 1] * // => [4, 5, 2, 3, 0, 1]
*/ */
function reduceRight(collection, iteratee, accumulator, thisArg) { var reduceRight = createReduce(arrayReduceRight, baseEachRight);
var initFromArray = arguments.length < 3;
return (typeof iteratee == 'function' && typeof thisArg == 'undefined' && isArray(collection))
? arrayReduceRight(collection, iteratee, accumulator, initFromArray)
: baseReduce(collection, getCallback(iteratee, thisArg, 4), accumulator, initFromArray, baseEachRight);
}
/** /**
* The opposite of `_.filter`; this method returns the elements of `collection` * The opposite of `_.filter`; this method returns the elements of `collection`
@@ -7276,7 +7318,7 @@
* bound('hi'); * bound('hi');
* // => 'hiya fred!' * // => 'hiya fred!'
*/ */
var bindKey = restParam(function(object, key, partials) { var bindKey = restParam(function(object, key, partials) {
var bitmask = BIND_FLAG | BIND_KEY_FLAG; var bitmask = BIND_FLAG | BIND_KEY_FLAG;
if (partials.length) { if (partials.length) {
var holders = replaceHolders(partials, bindKey.placeholder); var holders = replaceHolders(partials, bindKey.placeholder);
@@ -7325,14 +7367,7 @@
* curried(1)(_, 3)(2); * curried(1)(_, 3)(2);
* // => [1, 2, 3] * // => [1, 2, 3]
*/ */
function curry(func, arity, guard) { var curry = createCurry(CURRY_FLAG);
if (guard && isIterateeCall(func, arity, guard)) {
arity = null;
}
var result = createWrapper(func, CURRY_FLAG, null, null, null, null, null, arity);
result.placeholder = curry.placeholder;
return result;
}
/** /**
* This method is like `_.curry` except that arguments are applied to `func` * This method is like `_.curry` except that arguments are applied to `func`
@@ -7371,14 +7406,7 @@
* curried(3)(1, _)(2); * curried(3)(1, _)(2);
* // => [1, 2, 3] * // => [1, 2, 3]
*/ */
function curryRight(func, arity, guard) { var curryRight = createCurry(CURRY_RIGHT_FLAG);
if (guard && isIterateeCall(func, arity, guard)) {
arity = null;
}
var result = createWrapper(func, CURRY_RIGHT_FLAG, null, null, null, null, null, arity);
result.placeholder = curryRight.placeholder;
return result;
}
/** /**
* Creates a function that delays invoking `func` until after `wait` milliseconds * Creates a function that delays invoking `func` until after `wait` milliseconds
@@ -7797,10 +7825,7 @@
* greetFred('hi'); * greetFred('hi');
* // => 'hi fred' * // => 'hi fred'
*/ */
var partial = restParam(function(func, partials) { var partial = createPartial(PARTIAL_FLAG);
var holders = replaceHolders(partials, partial.placeholder);
return createWrapper(func, PARTIAL_FLAG, null, partials, holders);
});
/** /**
* This method is like `_.partial` except that partially applied arguments * This method is like `_.partial` except that partially applied arguments
@@ -7833,10 +7858,7 @@
* sayHelloTo('fred'); * sayHelloTo('fred');
* // => 'hello fred' * // => 'hello fred'
*/ */
var partialRight = restParam(function(func, partials) { var partialRight = createPartial(PARTIAL_RIGHT_FLAG);
var holders = replaceHolders(partials, partialRight.placeholder);
return createWrapper(func, PARTIAL_RIGHT_FLAG, null, partials, holders);
});
/** /**
* Creates a function that invokes `func` with arguments arranged according * Creates a function that invokes `func` with arguments arranged according
@@ -8970,10 +8992,7 @@
* _.findKey(users, 'active'); * _.findKey(users, 'active');
* // => 'barney' * // => 'barney'
*/ */
function findKey(object, predicate, thisArg) { var findKey = createFindKey(baseForOwn);
predicate = getCallback(predicate, thisArg, 3);
return baseFind(object, predicate, baseForOwn, true);
}
/** /**
* This method is like `_.findKey` except that it iterates over elements of * This method is like `_.findKey` except that it iterates over elements of
@@ -9023,10 +9042,7 @@
* _.findLastKey(users, 'active'); * _.findLastKey(users, 'active');
* // => 'pebbles' * // => 'pebbles'
*/ */
function findLastKey(object, predicate, thisArg) { var findLastKey = createFindKey(baseForOwnRight);
predicate = getCallback(predicate, thisArg, 3);
return baseFind(object, predicate, baseForOwnRight, true);
}
/** /**
* Iterates over own and inherited enumerable properties of an object invoking * Iterates over own and inherited enumerable properties of an object invoking
@@ -9055,12 +9071,7 @@
* }); * });
* // => logs 'a', 'b', and 'c' (iteration order is not guaranteed) * // => logs 'a', 'b', and 'c' (iteration order is not guaranteed)
*/ */
function forIn(object, iteratee, thisArg) { var forIn = createForIn(baseFor);
if (typeof iteratee != 'function' || typeof thisArg != 'undefined') {
iteratee = bindCallback(iteratee, thisArg, 3);
}
return baseFor(object, iteratee, keysIn);
}
/** /**
* This method is like `_.forIn` except that it iterates over properties of * This method is like `_.forIn` except that it iterates over properties of
@@ -9087,10 +9098,7 @@
* }); * });
* // => logs 'c', 'b', and 'a' assuming `_.forIn ` logs 'a', 'b', and 'c' * // => logs 'c', 'b', and 'a' assuming `_.forIn ` logs 'a', 'b', and 'c'
*/ */
function forInRight(object, iteratee, thisArg) { var forInRight = createForIn(baseForRight);
iteratee = bindCallback(iteratee, thisArg, 3);
return baseForRight(object, iteratee, keysIn);
}
/** /**
* Iterates over own enumerable properties of an object invoking `iteratee` * Iterates over own enumerable properties of an object invoking `iteratee`
@@ -9119,12 +9127,7 @@
* }); * });
* // => logs 'a' and 'b' (iteration order is not guaranteed) * // => logs 'a' and 'b' (iteration order is not guaranteed)
*/ */
function forOwn(object, iteratee, thisArg) { var forOwn = createForOwn(baseForOwn);
if (typeof iteratee != 'function' || typeof thisArg != 'undefined') {
iteratee = bindCallback(iteratee, thisArg, 3);
}
return baseForOwn(object, iteratee);
}
/** /**
* This method is like `_.forOwn` except that it iterates over properties of * This method is like `_.forOwn` except that it iterates over properties of
@@ -9151,10 +9154,7 @@
* }); * });
* // => logs 'b' and 'a' assuming `_.forOwn` logs 'a' and 'b' * // => logs 'b' and 'a' assuming `_.forOwn` logs 'a' and 'b'
*/ */
function forOwnRight(object, iteratee, thisArg) { var forOwnRight = createForOwn(baseForOwnRight);
iteratee = bindCallback(iteratee, thisArg, 3);
return baseForRight(object, iteratee, keys);
}
/** /**
* Creates an array of function property names from all enumerable properties, * Creates an array of function property names from all enumerable properties,
@@ -10068,10 +10068,7 @@
* _.padLeft('abc', 3); * _.padLeft('abc', 3);
* // => 'abc' * // => 'abc'
*/ */
function padLeft(string, length, chars) { var padLeft = createPadDir();
string = baseToString(string);
return string && (createPad(string, length, chars) + string);
}
/** /**
* Pads `string` on the right side if it is shorter then the given padding * Pads `string` on the right side if it is shorter then the given padding
@@ -10096,10 +10093,7 @@
* _.padRight('abc', 3); * _.padRight('abc', 3);
* // => 'abc' * // => 'abc'
*/ */
function padRight(string, length, chars) { var padRight = createPadDir(true);
string = baseToString(string);
return string && (string + createPad(string, length, chars));
}
/** /**
* Converts `string` to an integer of the specified radix. If `radix` is * Converts `string` to an integer of the specified radix. If `radix` is