You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3345 lines
99 KiB
3345 lines
99 KiB
9 years ago
|
/**
|
||
|
* @license
|
||
|
* lodash 4.6.1 (Custom Build) <https://lodash.com/>
|
||
|
* Build: `lodash include="range,isArray,isObject,escape,unescape,escapeRegExp,each,replace,map,isNumber,isUndefined" exports="global" -d`
|
||
|
* Copyright 2012-2016 The Dojo Foundation <http://dojofoundation.org/>
|
||
|
* Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
|
||
|
* Copyright 2009-2016 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
|
||
|
* Available under MIT license <https://lodash.com/license>
|
||
|
*/
|
||
|
;(function() {
|
||
|
|
||
|
/** Used as a safe reference for `undefined` in pre-ES5 environments. */
|
||
|
var undefined;
|
||
|
|
||
|
/** Used as the semantic version number. */
|
||
|
var VERSION = '4.6.1';
|
||
|
|
||
|
/** Used as the size to enable large array optimizations. */
|
||
|
var LARGE_ARRAY_SIZE = 200;
|
||
|
|
||
|
/** Used to stand-in for `undefined` hash values. */
|
||
|
var HASH_UNDEFINED = '__lodash_hash_undefined__';
|
||
|
|
||
|
/** Used to compose bitmasks for comparison styles. */
|
||
|
var UNORDERED_COMPARE_FLAG = 1,
|
||
|
PARTIAL_COMPARE_FLAG = 2;
|
||
|
|
||
|
/** Used as references for various `Number` constants. */
|
||
|
var INFINITY = 1 / 0,
|
||
|
MAX_SAFE_INTEGER = 9007199254740991,
|
||
|
NAN = 0 / 0;
|
||
|
|
||
|
/** `Object#toString` result references. */
|
||
|
var argsTag = '[object Arguments]',
|
||
|
arrayTag = '[object Array]',
|
||
|
boolTag = '[object Boolean]',
|
||
|
dateTag = '[object Date]',
|
||
|
errorTag = '[object Error]',
|
||
|
funcTag = '[object Function]',
|
||
|
genTag = '[object GeneratorFunction]',
|
||
|
mapTag = '[object Map]',
|
||
|
numberTag = '[object Number]',
|
||
|
objectTag = '[object Object]',
|
||
|
regexpTag = '[object RegExp]',
|
||
|
setTag = '[object Set]',
|
||
|
stringTag = '[object String]',
|
||
|
symbolTag = '[object Symbol]',
|
||
|
weakMapTag = '[object WeakMap]';
|
||
|
|
||
|
var arrayBufferTag = '[object ArrayBuffer]',
|
||
|
float32Tag = '[object Float32Array]',
|
||
|
float64Tag = '[object Float64Array]',
|
||
|
int8Tag = '[object Int8Array]',
|
||
|
int16Tag = '[object Int16Array]',
|
||
|
int32Tag = '[object Int32Array]',
|
||
|
uint8Tag = '[object Uint8Array]',
|
||
|
uint8ClampedTag = '[object Uint8ClampedArray]',
|
||
|
uint16Tag = '[object Uint16Array]',
|
||
|
uint32Tag = '[object Uint32Array]';
|
||
|
|
||
|
/** Used to match HTML entities and HTML characters. */
|
||
|
var reEscapedHtml = /&(?:amp|lt|gt|quot|#39|#96);/g,
|
||
|
reUnescapedHtml = /[&<>"'`]/g,
|
||
|
reHasEscapedHtml = RegExp(reEscapedHtml.source),
|
||
|
reHasUnescapedHtml = RegExp(reUnescapedHtml.source);
|
||
|
|
||
|
/** Used to match property names within property paths. */
|
||
|
var reIsDeepProp = /\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\\]|\\.)*?\1)\]/,
|
||
|
reIsPlainProp = /^\w*$/,
|
||
|
rePropName = /[^.[\]]+|\[(?:(-?\d+(?:\.\d+)?)|(["'])((?:(?!\2)[^\\]|\\.)*?)\2)\]/g;
|
||
|
|
||
|
/** Used to match `RegExp` [syntax characters](http://ecma-international.org/ecma-262/6.0/#sec-patterns). */
|
||
|
var reRegExpChar = /[\\^$.*+?()[\]{}|]/g,
|
||
|
reHasRegExpChar = RegExp(reRegExpChar.source);
|
||
|
|
||
|
/** Used to match leading and trailing whitespace. */
|
||
|
var reTrim = /^\s+|\s+$/g;
|
||
|
|
||
|
/** Used to match backslashes in property paths. */
|
||
|
var reEscapeChar = /\\(\\)?/g;
|
||
|
|
||
|
/** Used to match `RegExp` flags from their coerced string values. */
|
||
|
var reFlags = /\w*$/;
|
||
|
|
||
|
/** Used to detect bad signed hexadecimal string values. */
|
||
|
var reIsBadHex = /^[-+]0x[0-9a-f]+$/i;
|
||
|
|
||
|
/** Used to detect binary string values. */
|
||
|
var reIsBinary = /^0b[01]+$/i;
|
||
|
|
||
|
/** Used to detect host constructors (Safari > 5). */
|
||
|
var reIsHostCtor = /^\[object .+?Constructor\]$/;
|
||
|
|
||
|
/** Used to detect octal string values. */
|
||
|
var reIsOctal = /^0o[0-7]+$/i;
|
||
|
|
||
|
/** Used to detect unsigned integer values. */
|
||
|
var reIsUint = /^(?:0|[1-9]\d*)$/;
|
||
|
|
||
|
/** Used to identify `toStringTag` values of typed arrays. */
|
||
|
var typedArrayTags = {};
|
||
|
typedArrayTags[float32Tag] = typedArrayTags[float64Tag] =
|
||
|
typedArrayTags[int8Tag] = typedArrayTags[int16Tag] =
|
||
|
typedArrayTags[int32Tag] = typedArrayTags[uint8Tag] =
|
||
|
typedArrayTags[uint8ClampedTag] = typedArrayTags[uint16Tag] =
|
||
|
typedArrayTags[uint32Tag] = true;
|
||
|
typedArrayTags[argsTag] = typedArrayTags[arrayTag] =
|
||
|
typedArrayTags[arrayBufferTag] = typedArrayTags[boolTag] =
|
||
|
typedArrayTags[dateTag] = typedArrayTags[errorTag] =
|
||
|
typedArrayTags[funcTag] = typedArrayTags[mapTag] =
|
||
|
typedArrayTags[numberTag] = typedArrayTags[objectTag] =
|
||
|
typedArrayTags[regexpTag] = typedArrayTags[setTag] =
|
||
|
typedArrayTags[stringTag] = typedArrayTags[weakMapTag] = false;
|
||
|
|
||
|
/** Used to identify `toStringTag` values supported by `_.clone`. */
|
||
|
var cloneableTags = {};
|
||
|
cloneableTags[argsTag] = cloneableTags[arrayTag] =
|
||
|
cloneableTags[arrayBufferTag] = cloneableTags[boolTag] =
|
||
|
cloneableTags[dateTag] = cloneableTags[float32Tag] =
|
||
|
cloneableTags[float64Tag] = cloneableTags[int8Tag] =
|
||
|
cloneableTags[int16Tag] = cloneableTags[int32Tag] =
|
||
|
cloneableTags[mapTag] = cloneableTags[numberTag] =
|
||
|
cloneableTags[objectTag] = cloneableTags[regexpTag] =
|
||
|
cloneableTags[setTag] = cloneableTags[stringTag] =
|
||
|
cloneableTags[symbolTag] = cloneableTags[uint8Tag] =
|
||
|
cloneableTags[uint8ClampedTag] = cloneableTags[uint16Tag] =
|
||
|
cloneableTags[uint32Tag] = true;
|
||
|
cloneableTags[errorTag] = cloneableTags[funcTag] =
|
||
|
cloneableTags[weakMapTag] = false;
|
||
|
|
||
|
/** Used to map characters to HTML entities. */
|
||
|
var htmlEscapes = {
|
||
|
'&': '&',
|
||
|
'<': '<',
|
||
|
'>': '>',
|
||
|
'"': '"',
|
||
|
"'": ''',
|
||
|
'`': '`'
|
||
|
};
|
||
|
|
||
|
/** Used to map HTML entities to characters. */
|
||
|
var htmlUnescapes = {
|
||
|
'&': '&',
|
||
|
'<': '<',
|
||
|
'>': '>',
|
||
|
'"': '"',
|
||
|
''': "'",
|
||
|
'`': '`'
|
||
|
};
|
||
|
|
||
|
/** Used to determine if values are of the language type `Object`. */
|
||
|
var objectTypes = {
|
||
|
'function': true,
|
||
|
'object': true
|
||
|
};
|
||
|
|
||
|
/** Built-in method references without a dependency on `root`. */
|
||
|
var freeParseInt = parseInt;
|
||
|
|
||
|
/** Detect free variable `exports`. */
|
||
|
var freeExports = (objectTypes[typeof exports] && exports && !exports.nodeType)
|
||
|
? exports
|
||
|
: undefined;
|
||
|
|
||
|
/** Detect free variable `module`. */
|
||
|
var freeModule = (objectTypes[typeof module] && module && !module.nodeType)
|
||
|
? module
|
||
|
: undefined;
|
||
|
|
||
|
/** Detect the popular CommonJS extension `module.exports`. */
|
||
|
var moduleExports = (freeModule && freeModule.exports === freeExports)
|
||
|
? freeExports
|
||
|
: undefined;
|
||
|
|
||
|
/** Detect free variable `global` from Node.js. */
|
||
|
var freeGlobal = checkGlobal(freeExports && freeModule && typeof global == 'object' && global);
|
||
|
|
||
|
/** Detect free variable `self`. */
|
||
|
var freeSelf = checkGlobal(objectTypes[typeof self] && self);
|
||
|
|
||
|
/** Detect free variable `window`. */
|
||
|
var freeWindow = checkGlobal(objectTypes[typeof window] && window);
|
||
|
|
||
|
/** Detect `this` as the global object. */
|
||
|
var thisGlobal = checkGlobal(objectTypes[typeof this] && this);
|
||
|
|
||
|
/**
|
||
|
* Used as a reference to the global object.
|
||
|
*
|
||
|
* The `this` value is used if it's the global object to avoid Greasemonkey's
|
||
|
* restricted `window` object, otherwise the `window` object is used.
|
||
|
*/
|
||
|
var root = freeGlobal ||
|
||
|
((freeWindow !== (thisGlobal && thisGlobal.window)) && freeWindow) ||
|
||
|
freeSelf || thisGlobal || Function('return this')();
|
||
|
|
||
|
/*--------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Adds the key-value `pair` to `map`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} map The map to modify.
|
||
|
* @param {Array} pair The key-value pair to add.
|
||
|
* @returns {Object} Returns `map`.
|
||
|
*/
|
||
|
function addMapEntry(map, pair) {
|
||
|
// Don't return `Map#set` because it doesn't return the map instance in IE 11.
|
||
|
map.set(pair[0], pair[1]);
|
||
|
return map;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Adds `value` to `set`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} set The set to modify.
|
||
|
* @param {*} value The value to add.
|
||
|
* @returns {Object} Returns `set`.
|
||
|
*/
|
||
|
function addSetEntry(set, value) {
|
||
|
set.add(value);
|
||
|
return set;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* A specialized version of `_.forEach` for arrays without support for
|
||
|
* iteratee shorthands.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to iterate over.
|
||
|
* @param {Function} iteratee The function invoked per iteration.
|
||
|
* @returns {Array} Returns `array`.
|
||
|
*/
|
||
|
function arrayEach(array, iteratee) {
|
||
|
var index = -1,
|
||
|
length = array.length;
|
||
|
|
||
|
while (++index < length) {
|
||
|
if (iteratee(array[index], index, array) === false) {
|
||
|
break;
|
||
|
}
|
||
|
}
|
||
|
return array;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* A specialized version of `_.map` for arrays without support for iteratee
|
||
|
* shorthands.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to iterate over.
|
||
|
* @param {Function} iteratee The function invoked per iteration.
|
||
|
* @returns {Array} Returns the new mapped array.
|
||
|
*/
|
||
|
function arrayMap(array, iteratee) {
|
||
|
var index = -1,
|
||
|
length = array.length,
|
||
|
result = Array(length);
|
||
|
|
||
|
while (++index < length) {
|
||
|
result[index] = iteratee(array[index], index, array);
|
||
|
}
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* A specialized version of `_.reduce` for arrays without support for
|
||
|
* iteratee shorthands.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to iterate over.
|
||
|
* @param {Function} iteratee The function invoked per iteration.
|
||
|
* @param {*} [accumulator] The initial value.
|
||
|
* @param {boolean} [initAccum] Specify using the first element of `array` as the initial value.
|
||
|
* @returns {*} Returns the accumulated value.
|
||
|
*/
|
||
|
function arrayReduce(array, iteratee, accumulator, initAccum) {
|
||
|
var index = -1,
|
||
|
length = array.length;
|
||
|
|
||
|
if (initAccum && length) {
|
||
|
accumulator = array[++index];
|
||
|
}
|
||
|
while (++index < length) {
|
||
|
accumulator = iteratee(accumulator, array[index], index, array);
|
||
|
}
|
||
|
return accumulator;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* A specialized version of `_.some` for arrays without support for iteratee
|
||
|
* shorthands.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to iterate over.
|
||
|
* @param {Function} predicate The function invoked per iteration.
|
||
|
* @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
|
||
|
*/
|
||
|
function arraySome(array, predicate) {
|
||
|
var index = -1,
|
||
|
length = array.length;
|
||
|
|
||
|
while (++index < length) {
|
||
|
if (predicate(array[index], index, array)) {
|
||
|
return true;
|
||
|
}
|
||
|
}
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.times` without support for iteratee shorthands
|
||
|
* or max array length checks.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {number} n The number of times to invoke `iteratee`.
|
||
|
* @param {Function} iteratee The function invoked per iteration.
|
||
|
* @returns {Array} Returns the array of results.
|
||
|
*/
|
||
|
function baseTimes(n, iteratee) {
|
||
|
var index = -1,
|
||
|
result = Array(n);
|
||
|
|
||
|
while (++index < n) {
|
||
|
result[index] = iteratee(index);
|
||
|
}
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.toPairs` and `_.toPairsIn` which creates an array
|
||
|
* of key-value pairs for `object` corresponding to the property names of `props`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @param {Array} props The property names to get values for.
|
||
|
* @returns {Object} Returns the new array of key-value pairs.
|
||
|
*/
|
||
|
function baseToPairs(object, props) {
|
||
|
return arrayMap(props, function(key) {
|
||
|
return [key, object[key]];
|
||
|
});
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is a global object.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {null|Object} Returns `value` if it's a global object, else `null`.
|
||
|
*/
|
||
|
function checkGlobal(value) {
|
||
|
return (value && value.Object === Object) ? value : null;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Used by `_.escape` to convert characters to HTML entities.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {string} chr The matched character to escape.
|
||
|
* @returns {string} Returns the escaped character.
|
||
|
*/
|
||
|
function escapeHtmlChar(chr) {
|
||
|
return htmlEscapes[chr];
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is a host object in IE < 9.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is a host object, else `false`.
|
||
|
*/
|
||
|
function isHostObject(value) {
|
||
|
// Many host objects are `Object` objects that can coerce to strings
|
||
|
// despite having improperly defined `toString` methods.
|
||
|
var result = false;
|
||
|
if (value != null && typeof value.toString != 'function') {
|
||
|
try {
|
||
|
result = !!(value + '');
|
||
|
} catch (e) {}
|
||
|
}
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is a valid array-like index.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to check.
|
||
|
* @param {number} [length=MAX_SAFE_INTEGER] The upper bounds of a valid index.
|
||
|
* @returns {boolean} Returns `true` if `value` is a valid index, else `false`.
|
||
|
*/
|
||
|
function isIndex(value, length) {
|
||
|
value = (typeof value == 'number' || reIsUint.test(value)) ? +value : -1;
|
||
|
length = length == null ? MAX_SAFE_INTEGER : length;
|
||
|
return value > -1 && value % 1 == 0 && value < length;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Converts `map` to an array.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} map The map to convert.
|
||
|
* @returns {Array} Returns the converted array.
|
||
|
*/
|
||
|
function mapToArray(map) {
|
||
|
var index = -1,
|
||
|
result = Array(map.size);
|
||
|
|
||
|
map.forEach(function(value, key) {
|
||
|
result[++index] = [key, value];
|
||
|
});
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Converts `set` to an array.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} set The set to convert.
|
||
|
* @returns {Array} Returns the converted array.
|
||
|
*/
|
||
|
function setToArray(set) {
|
||
|
var index = -1,
|
||
|
result = Array(set.size);
|
||
|
|
||
|
set.forEach(function(value) {
|
||
|
result[++index] = value;
|
||
|
});
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Used by `_.unescape` to convert HTML entities to characters.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {string} chr The matched character to unescape.
|
||
|
* @returns {string} Returns the unescaped character.
|
||
|
*/
|
||
|
function unescapeHtmlChar(chr) {
|
||
|
return htmlUnescapes[chr];
|
||
|
}
|
||
|
|
||
|
/*--------------------------------------------------------------------------*/
|
||
|
|
||
|
/** Used for built-in method references. */
|
||
|
var arrayProto = Array.prototype,
|
||
|
objectProto = Object.prototype;
|
||
|
|
||
|
/** Used to resolve the decompiled source of functions. */
|
||
|
var funcToString = Function.prototype.toString;
|
||
|
|
||
|
/** Used to check objects for own properties. */
|
||
|
var hasOwnProperty = objectProto.hasOwnProperty;
|
||
|
|
||
|
/**
|
||
|
* Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring)
|
||
|
* of values.
|
||
|
*/
|
||
|
var objectToString = objectProto.toString;
|
||
|
|
||
|
/** Used to detect if a method is native. */
|
||
|
var reIsNative = RegExp('^' +
|
||
|
funcToString.call(hasOwnProperty).replace(reRegExpChar, '\\$&')
|
||
|
.replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g, '$1.*?') + '$'
|
||
|
);
|
||
|
|
||
|
/** Built-in value references. */
|
||
|
var Buffer = moduleExports ? root.Buffer : undefined,
|
||
|
Symbol = root.Symbol,
|
||
|
Uint8Array = root.Uint8Array,
|
||
|
getPrototypeOf = Object.getPrototypeOf,
|
||
|
getOwnPropertySymbols = Object.getOwnPropertySymbols,
|
||
|
objectCreate = Object.create,
|
||
|
propertyIsEnumerable = objectProto.propertyIsEnumerable,
|
||
|
splice = arrayProto.splice;
|
||
|
|
||
|
/* Built-in method references for those with the same name as other `lodash` methods. */
|
||
|
var nativeCeil = Math.ceil,
|
||
|
nativeKeys = Object.keys,
|
||
|
nativeMax = Math.max;
|
||
|
|
||
|
/* Built-in method references that are verified to be native. */
|
||
|
var Map = getNative(root, 'Map'),
|
||
|
Set = getNative(root, 'Set'),
|
||
|
WeakMap = getNative(root, 'WeakMap'),
|
||
|
nativeCreate = getNative(Object, 'create');
|
||
|
|
||
|
/** Used to lookup unminified function names. */
|
||
|
var realNames = {};
|
||
|
|
||
|
/** Used to detect maps, sets, and weakmaps. */
|
||
|
var mapCtorString = Map ? funcToString.call(Map) : '',
|
||
|
setCtorString = Set ? funcToString.call(Set) : '',
|
||
|
weakMapCtorString = WeakMap ? funcToString.call(WeakMap) : '';
|
||
|
|
||
|
/** Used to convert symbols to primitives and strings. */
|
||
|
var symbolProto = Symbol ? Symbol.prototype : undefined,
|
||
|
symbolValueOf = symbolProto ? symbolProto.valueOf : undefined,
|
||
|
symbolToString = symbolProto ? symbolProto.toString : undefined;
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Creates a `lodash` object which wraps `value` to enable implicit method
|
||
|
* chaining. Methods that operate on and return arrays, collections, and
|
||
|
* functions can be chained together. Methods that retrieve a single value or
|
||
|
* may return a primitive value will automatically end the chain sequence and
|
||
|
* return the unwrapped value. Otherwise, the value must be unwrapped with
|
||
|
* `_#value`.
|
||
|
*
|
||
|
* Explicit chaining, which must be unwrapped with `_#value` in all cases,
|
||
|
* may be enabled using `_.chain`.
|
||
|
*
|
||
|
* The execution of chained methods is lazy, that is, it's deferred until
|
||
|
* `_#value` is implicitly or explicitly called.
|
||
|
*
|
||
|
* Lazy evaluation allows several methods to support shortcut fusion. Shortcut
|
||
|
* fusion is an optimization to merge iteratee calls; this avoids the creation
|
||
|
* of intermediate arrays and can greatly reduce the number of iteratee executions.
|
||
|
* Sections of a chain sequence qualify for shortcut fusion if the section is
|
||
|
* applied to an array of at least two hundred elements and any iteratees
|
||
|
* accept only one argument. The heuristic for whether a section qualifies
|
||
|
* for shortcut fusion is subject to change.
|
||
|
*
|
||
|
* Chaining is supported in custom builds as long as the `_#value` method is
|
||
|
* directly or indirectly included in the build.
|
||
|
*
|
||
|
* In addition to lodash methods, wrappers have `Array` and `String` methods.
|
||
|
*
|
||
|
* The wrapper `Array` methods are:
|
||
|
* `concat`, `join`, `pop`, `push`, `shift`, `sort`, `splice`, and `unshift`
|
||
|
*
|
||
|
* The wrapper `String` methods are:
|
||
|
* `replace` and `split`
|
||
|
*
|
||
|
* The wrapper methods that support shortcut fusion are:
|
||
|
* `at`, `compact`, `drop`, `dropRight`, `dropWhile`, `filter`, `find`,
|
||
|
* `findLast`, `head`, `initial`, `last`, `map`, `reject`, `reverse`, `slice`,
|
||
|
* `tail`, `take`, `takeRight`, `takeRightWhile`, `takeWhile`, and `toArray`
|
||
|
*
|
||
|
* The chainable wrapper methods are:
|
||
|
* `after`, `ary`, `assign`, `assignIn`, `assignInWith`, `assignWith`, `at`,
|
||
|
* `before`, `bind`, `bindAll`, `bindKey`, `castArray`, `chain`, `chunk`,
|
||
|
* `commit`, `compact`, `concat`, `conforms`, `constant`, `countBy`, `create`,
|
||
|
* `curry`, `debounce`, `defaults`, `defaultsDeep`, `defer`, `delay`,
|
||
|
* `difference`, `differenceBy`, `differenceWith`, `drop`, `dropRight`,
|
||
|
* `dropRightWhile`, `dropWhile`, `extend`, `extendWith`, `fill`, `filter`,
|
||
|
* `flatten`, `flattenDeep`, `flattenDepth`, `flip`, `flow`, `flowRight`,
|
||
|
* `fromPairs`, `functions`, `functionsIn`, `groupBy`, `initial`, `intersection`,
|
||
|
* `intersectionBy`, `intersectionWith`, `invert`, `invertBy`, `invokeMap`,
|
||
|
* `iteratee`, `keyBy`, `keys`, `keysIn`, `map`, `mapKeys`, `mapValues`,
|
||
|
* `matches`, `matchesProperty`, `memoize`, `merge`, `mergeWith`, `method`,
|
||
|
* `methodOf`, `mixin`, `negate`, `nthArg`, `omit`, `omitBy`, `once`, `orderBy`,
|
||
|
* `over`, `overArgs`, `overEvery`, `overSome`, `partial`, `partialRight`,
|
||
|
* `partition`, `pick`, `pickBy`, `plant`, `property`, `propertyOf`, `pull`,
|
||
|
* `pullAll`, `pullAllBy`, `pullAllWith`, `pullAt`, `push`, `range`,
|
||
|
* `rangeRight`, `rearg`, `reject`, `remove`, `rest`, `reverse`, `sampleSize`,
|
||
|
* `set`, `setWith`, `shuffle`, `slice`, `sort`, `sortBy`, `splice`, `spread`,
|
||
|
* `tail`, `take`, `takeRight`, `takeRightWhile`, `takeWhile`, `tap`, `throttle`,
|
||
|
* `thru`, `toArray`, `toPairs`, `toPairsIn`, `toPath`, `toPlainObject`,
|
||
|
* `transform`, `unary`, `union`, `unionBy`, `unionWith`, `uniq`, `uniqBy`,
|
||
|
* `uniqWith`, `unset`, `unshift`, `unzip`, `unzipWith`, `update`, `values`,
|
||
|
* `valuesIn`, `without`, `wrap`, `xor`, `xorBy`, `xorWith`, `zip`, `zipObject`,
|
||
|
* `zipObjectDeep`, and `zipWith`
|
||
|
*
|
||
|
* The wrapper methods that are **not** chainable by default are:
|
||
|
* `add`, `attempt`, `camelCase`, `capitalize`, `ceil`, `clamp`, `clone`,
|
||
|
* `cloneDeep`, `cloneDeepWith`, `cloneWith`, `deburr`, `each`, `eachRight`,
|
||
|
* `endsWith`, `eq`, `escape`, `escapeRegExp`, `every`, `find`, `findIndex`,
|
||
|
* `findKey`, `findLast`, `findLastIndex`, `findLastKey`, `first`, `floor`,
|
||
|
* `forEach`, `forEachRight`, `forIn`, `forInRight`, `forOwn`, `forOwnRight`,
|
||
|
* `get`, `gt`, `gte`, `has`, `hasIn`, `head`, `identity`, `includes`,
|
||
|
* `indexOf`, `inRange`, `invoke`, `isArguments`, `isArray`, `isArrayBuffer`,
|
||
|
* `isArrayLike`, `isArrayLikeObject`, `isBoolean`, `isBuffer`, `isDate`,
|
||
|
* `isElement`, `isEmpty`, `isEqual`, `isEqualWith`, `isError`, `isFinite`,
|
||
|
* `isFunction`, `isInteger`, `isLength`, `isMap`, `isMatch`, `isMatchWith`,
|
||
|
* `isNaN`, `isNative`, `isNil`, `isNull`, `isNumber`, `isObject`, `isObjectLike`,
|
||
|
* `isPlainObject`, `isRegExp`, `isSafeInteger`, `isSet`, `isString`,
|
||
|
* `isUndefined`, `isTypedArray`, `isWeakMap`, `isWeakSet`, `join`, `kebabCase`,
|
||
|
* `last`, `lastIndexOf`, `lowerCase`, `lowerFirst`, `lt`, `lte`, `max`,
|
||
|
* `maxBy`, `mean`, `min`, `minBy`, `noConflict`, `noop`, `now`, `pad`,
|
||
|
* `padEnd`, `padStart`, `parseInt`, `pop`, `random`, `reduce`, `reduceRight`,
|
||
|
* `repeat`, `result`, `round`, `runInContext`, `sample`, `shift`, `size`,
|
||
|
* `snakeCase`, `some`, `sortedIndex`, `sortedIndexBy`, `sortedLastIndex`,
|
||
|
* `sortedLastIndexBy`, `startCase`, `startsWith`, `subtract`, `sum`, `sumBy`,
|
||
|
* `template`, `times`, `toInteger`, `toJSON`, `toLength`, `toLower`,
|
||
|
* `toNumber`, `toSafeInteger`, `toString`, `toUpper`, `trim`, `trimEnd`,
|
||
|
* `trimStart`, `truncate`, `unescape`, `uniqueId`, `upperCase`, `upperFirst`,
|
||
|
* `value`, and `words`
|
||
|
*
|
||
|
* @name _
|
||
|
* @constructor
|
||
|
* @category Seq
|
||
|
* @param {*} value The value to wrap in a `lodash` instance.
|
||
|
* @returns {Object} Returns the new `lodash` wrapper instance.
|
||
|
* @example
|
||
|
*
|
||
|
* function square(n) {
|
||
|
* return n * n;
|
||
|
* }
|
||
|
*
|
||
|
* var wrapped = _([1, 2, 3]);
|
||
|
*
|
||
|
* // Returns an unwrapped value.
|
||
|
* wrapped.reduce(_.add);
|
||
|
* // => 6
|
||
|
*
|
||
|
* // Returns a wrapped value.
|
||
|
* var squares = wrapped.map(square);
|
||
|
*
|
||
|
* _.isArray(squares);
|
||
|
* // => false
|
||
|
*
|
||
|
* _.isArray(squares.value());
|
||
|
* // => true
|
||
|
*/
|
||
|
function lodash() {
|
||
|
// No operation performed.
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Creates an hash object.
|
||
|
*
|
||
|
* @private
|
||
|
* @constructor
|
||
|
* @returns {Object} Returns the new hash object.
|
||
|
*/
|
||
|
function Hash() {}
|
||
|
|
||
|
/**
|
||
|
* Removes `key` and its value from the hash.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} hash The hash to modify.
|
||
|
* @param {string} key The key of the value to remove.
|
||
|
* @returns {boolean} Returns `true` if the entry was removed, else `false`.
|
||
|
*/
|
||
|
function hashDelete(hash, key) {
|
||
|
return hashHas(hash, key) && delete hash[key];
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Gets the hash value for `key`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} hash The hash to query.
|
||
|
* @param {string} key The key of the value to get.
|
||
|
* @returns {*} Returns the entry value.
|
||
|
*/
|
||
|
function hashGet(hash, key) {
|
||
|
if (nativeCreate) {
|
||
|
var result = hash[key];
|
||
|
return result === HASH_UNDEFINED ? undefined : result;
|
||
|
}
|
||
|
return hasOwnProperty.call(hash, key) ? hash[key] : undefined;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if a hash value for `key` exists.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} hash The hash to query.
|
||
|
* @param {string} key The key of the entry to check.
|
||
|
* @returns {boolean} Returns `true` if an entry for `key` exists, else `false`.
|
||
|
*/
|
||
|
function hashHas(hash, key) {
|
||
|
return nativeCreate ? hash[key] !== undefined : hasOwnProperty.call(hash, key);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Sets the hash `key` to `value`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} hash The hash to modify.
|
||
|
* @param {string} key The key of the value to set.
|
||
|
* @param {*} value The value to set.
|
||
|
*/
|
||
|
function hashSet(hash, key, value) {
|
||
|
hash[key] = (nativeCreate && value === undefined) ? HASH_UNDEFINED : value;
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Creates a map cache object to store key-value pairs.
|
||
|
*
|
||
|
* @private
|
||
|
* @constructor
|
||
|
* @param {Array} [values] The values to cache.
|
||
|
*/
|
||
|
function MapCache(values) {
|
||
|
var index = -1,
|
||
|
length = values ? values.length : 0;
|
||
|
|
||
|
this.clear();
|
||
|
while (++index < length) {
|
||
|
var entry = values[index];
|
||
|
this.set(entry[0], entry[1]);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Removes all key-value entries from the map.
|
||
|
*
|
||
|
* @private
|
||
|
* @name clear
|
||
|
* @memberOf MapCache
|
||
|
*/
|
||
|
function mapClear() {
|
||
|
this.__data__ = {
|
||
|
'hash': new Hash,
|
||
|
'map': Map ? new Map : [],
|
||
|
'string': new Hash
|
||
|
};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Removes `key` and its value from the map.
|
||
|
*
|
||
|
* @private
|
||
|
* @name delete
|
||
|
* @memberOf MapCache
|
||
|
* @param {string} key The key of the value to remove.
|
||
|
* @returns {boolean} Returns `true` if the entry was removed, else `false`.
|
||
|
*/
|
||
|
function mapDelete(key) {
|
||
|
var data = this.__data__;
|
||
|
if (isKeyable(key)) {
|
||
|
return hashDelete(typeof key == 'string' ? data.string : data.hash, key);
|
||
|
}
|
||
|
return Map ? data.map['delete'](key) : assocDelete(data.map, key);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Gets the map value for `key`.
|
||
|
*
|
||
|
* @private
|
||
|
* @name get
|
||
|
* @memberOf MapCache
|
||
|
* @param {string} key The key of the value to get.
|
||
|
* @returns {*} Returns the entry value.
|
||
|
*/
|
||
|
function mapGet(key) {
|
||
|
var data = this.__data__;
|
||
|
if (isKeyable(key)) {
|
||
|
return hashGet(typeof key == 'string' ? data.string : data.hash, key);
|
||
|
}
|
||
|
return Map ? data.map.get(key) : assocGet(data.map, key);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if a map value for `key` exists.
|
||
|
*
|
||
|
* @private
|
||
|
* @name has
|
||
|
* @memberOf MapCache
|
||
|
* @param {string} key The key of the entry to check.
|
||
|
* @returns {boolean} Returns `true` if an entry for `key` exists, else `false`.
|
||
|
*/
|
||
|
function mapHas(key) {
|
||
|
var data = this.__data__;
|
||
|
if (isKeyable(key)) {
|
||
|
return hashHas(typeof key == 'string' ? data.string : data.hash, key);
|
||
|
}
|
||
|
return Map ? data.map.has(key) : assocHas(data.map, key);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Sets the map `key` to `value`.
|
||
|
*
|
||
|
* @private
|
||
|
* @name set
|
||
|
* @memberOf MapCache
|
||
|
* @param {string} key The key of the value to set.
|
||
|
* @param {*} value The value to set.
|
||
|
* @returns {Object} Returns the map cache object.
|
||
|
*/
|
||
|
function mapSet(key, value) {
|
||
|
var data = this.__data__;
|
||
|
if (isKeyable(key)) {
|
||
|
hashSet(typeof key == 'string' ? data.string : data.hash, key, value);
|
||
|
} else if (Map) {
|
||
|
data.map.set(key, value);
|
||
|
} else {
|
||
|
assocSet(data.map, key, value);
|
||
|
}
|
||
|
return this;
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Creates a stack cache object to store key-value pairs.
|
||
|
*
|
||
|
* @private
|
||
|
* @constructor
|
||
|
* @param {Array} [values] The values to cache.
|
||
|
*/
|
||
|
function Stack(values) {
|
||
|
var index = -1,
|
||
|
length = values ? values.length : 0;
|
||
|
|
||
|
this.clear();
|
||
|
while (++index < length) {
|
||
|
var entry = values[index];
|
||
|
this.set(entry[0], entry[1]);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Removes all key-value entries from the stack.
|
||
|
*
|
||
|
* @private
|
||
|
* @name clear
|
||
|
* @memberOf Stack
|
||
|
*/
|
||
|
function stackClear() {
|
||
|
this.__data__ = { 'array': [], 'map': null };
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Removes `key` and its value from the stack.
|
||
|
*
|
||
|
* @private
|
||
|
* @name delete
|
||
|
* @memberOf Stack
|
||
|
* @param {string} key The key of the value to remove.
|
||
|
* @returns {boolean} Returns `true` if the entry was removed, else `false`.
|
||
|
*/
|
||
|
function stackDelete(key) {
|
||
|
var data = this.__data__,
|
||
|
array = data.array;
|
||
|
|
||
|
return array ? assocDelete(array, key) : data.map['delete'](key);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Gets the stack value for `key`.
|
||
|
*
|
||
|
* @private
|
||
|
* @name get
|
||
|
* @memberOf Stack
|
||
|
* @param {string} key The key of the value to get.
|
||
|
* @returns {*} Returns the entry value.
|
||
|
*/
|
||
|
function stackGet(key) {
|
||
|
var data = this.__data__,
|
||
|
array = data.array;
|
||
|
|
||
|
return array ? assocGet(array, key) : data.map.get(key);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if a stack value for `key` exists.
|
||
|
*
|
||
|
* @private
|
||
|
* @name has
|
||
|
* @memberOf Stack
|
||
|
* @param {string} key The key of the entry to check.
|
||
|
* @returns {boolean} Returns `true` if an entry for `key` exists, else `false`.
|
||
|
*/
|
||
|
function stackHas(key) {
|
||
|
var data = this.__data__,
|
||
|
array = data.array;
|
||
|
|
||
|
return array ? assocHas(array, key) : data.map.has(key);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Sets the stack `key` to `value`.
|
||
|
*
|
||
|
* @private
|
||
|
* @name set
|
||
|
* @memberOf Stack
|
||
|
* @param {string} key The key of the value to set.
|
||
|
* @param {*} value The value to set.
|
||
|
* @returns {Object} Returns the stack cache object.
|
||
|
*/
|
||
|
function stackSet(key, value) {
|
||
|
var data = this.__data__,
|
||
|
array = data.array;
|
||
|
|
||
|
if (array) {
|
||
|
if (array.length < (LARGE_ARRAY_SIZE - 1)) {
|
||
|
assocSet(array, key, value);
|
||
|
} else {
|
||
|
data.array = null;
|
||
|
data.map = new MapCache(array);
|
||
|
}
|
||
|
}
|
||
|
var map = data.map;
|
||
|
if (map) {
|
||
|
map.set(key, value);
|
||
|
}
|
||
|
return this;
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Removes `key` and its value from the associative array.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to query.
|
||
|
* @param {string} key The key of the value to remove.
|
||
|
* @returns {boolean} Returns `true` if the entry was removed, else `false`.
|
||
|
*/
|
||
|
function assocDelete(array, key) {
|
||
|
var index = assocIndexOf(array, key);
|
||
|
if (index < 0) {
|
||
|
return false;
|
||
|
}
|
||
|
var lastIndex = array.length - 1;
|
||
|
if (index == lastIndex) {
|
||
|
array.pop();
|
||
|
} else {
|
||
|
splice.call(array, index, 1);
|
||
|
}
|
||
|
return true;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Gets the associative array value for `key`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to query.
|
||
|
* @param {string} key The key of the value to get.
|
||
|
* @returns {*} Returns the entry value.
|
||
|
*/
|
||
|
function assocGet(array, key) {
|
||
|
var index = assocIndexOf(array, key);
|
||
|
return index < 0 ? undefined : array[index][1];
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if an associative array value for `key` exists.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to query.
|
||
|
* @param {string} key The key of the entry to check.
|
||
|
* @returns {boolean} Returns `true` if an entry for `key` exists, else `false`.
|
||
|
*/
|
||
|
function assocHas(array, key) {
|
||
|
return assocIndexOf(array, key) > -1;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Gets the index at which the first occurrence of `key` is found in `array`
|
||
|
* of key-value pairs.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to search.
|
||
|
* @param {*} key The key to search for.
|
||
|
* @returns {number} Returns the index of the matched value, else `-1`.
|
||
|
*/
|
||
|
function assocIndexOf(array, key) {
|
||
|
var length = array.length;
|
||
|
while (length--) {
|
||
|
if (eq(array[length][0], key)) {
|
||
|
return length;
|
||
|
}
|
||
|
}
|
||
|
return -1;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Sets the associative array `key` to `value`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to modify.
|
||
|
* @param {string} key The key of the value to set.
|
||
|
* @param {*} value The value to set.
|
||
|
*/
|
||
|
function assocSet(array, key, value) {
|
||
|
var index = assocIndexOf(array, key);
|
||
|
if (index < 0) {
|
||
|
array.push([key, value]);
|
||
|
} else {
|
||
|
array[index][1] = value;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Assigns `value` to `key` of `object` if the existing value is not equivalent
|
||
|
* using [`SameValueZero`](http://ecma-international.org/ecma-262/6.0/#sec-samevaluezero)
|
||
|
* for equality comparisons.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to modify.
|
||
|
* @param {string} key The key of the property to assign.
|
||
|
* @param {*} value The value to assign.
|
||
|
*/
|
||
|
function assignValue(object, key, value) {
|
||
|
var objValue = object[key];
|
||
|
if (!(hasOwnProperty.call(object, key) && eq(objValue, value)) ||
|
||
|
(value === undefined && !(key in object))) {
|
||
|
object[key] = value;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.assign` without support for multiple sources
|
||
|
* or `customizer` functions.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The destination object.
|
||
|
* @param {Object} source The source object.
|
||
|
* @returns {Object} Returns `object`.
|
||
|
*/
|
||
|
function baseAssign(object, source) {
|
||
|
return object && copyObject(source, keys(source), object);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Casts `value` to `identity` if it's not a function.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to inspect.
|
||
|
* @returns {Array} Returns the array-like object.
|
||
|
*/
|
||
|
function baseCastFunction(value) {
|
||
|
return typeof value == 'function' ? value : identity;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Casts `value` to a path array if it's not one.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to inspect.
|
||
|
* @returns {Array} Returns the cast property path array.
|
||
|
*/
|
||
|
function baseCastPath(value) {
|
||
|
return isArray(value) ? value : stringToPath(value);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.clone` and `_.cloneDeep` which tracks
|
||
|
* traversed objects.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to clone.
|
||
|
* @param {boolean} [isDeep] Specify a deep clone.
|
||
|
* @param {boolean} [isFull] Specify a clone including symbols.
|
||
|
* @param {Function} [customizer] The function to customize cloning.
|
||
|
* @param {string} [key] The key of `value`.
|
||
|
* @param {Object} [object] The parent object of `value`.
|
||
|
* @param {Object} [stack] Tracks traversed objects and their clone counterparts.
|
||
|
* @returns {*} Returns the cloned value.
|
||
|
*/
|
||
|
function baseClone(value, isDeep, isFull, customizer, key, object, stack) {
|
||
|
var result;
|
||
|
if (customizer) {
|
||
|
result = object ? customizer(value, key, object, stack) : customizer(value);
|
||
|
}
|
||
|
if (result !== undefined) {
|
||
|
return result;
|
||
|
}
|
||
|
if (!isObject(value)) {
|
||
|
return value;
|
||
|
}
|
||
|
var isArr = isArray(value);
|
||
|
if (isArr) {
|
||
|
result = initCloneArray(value);
|
||
|
if (!isDeep) {
|
||
|
return copyArray(value, result);
|
||
|
}
|
||
|
} else {
|
||
|
var tag = getTag(value),
|
||
|
isFunc = tag == funcTag || tag == genTag;
|
||
|
|
||
|
if (isBuffer(value)) {
|
||
|
return cloneBuffer(value, isDeep);
|
||
|
}
|
||
|
if (tag == objectTag || tag == argsTag || (isFunc && !object)) {
|
||
|
if (isHostObject(value)) {
|
||
|
return object ? value : {};
|
||
|
}
|
||
|
result = initCloneObject(isFunc ? {} : value);
|
||
|
if (!isDeep) {
|
||
|
result = baseAssign(result, value);
|
||
|
return isFull ? copySymbols(value, result) : result;
|
||
|
}
|
||
|
} else {
|
||
|
if (!cloneableTags[tag]) {
|
||
|
return object ? value : {};
|
||
|
}
|
||
|
result = initCloneByTag(value, tag, isDeep);
|
||
|
}
|
||
|
}
|
||
|
// Check for circular references and return its corresponding clone.
|
||
|
stack || (stack = new Stack);
|
||
|
var stacked = stack.get(value);
|
||
|
if (stacked) {
|
||
|
return stacked;
|
||
|
}
|
||
|
stack.set(value, result);
|
||
|
|
||
|
// Recursively populate clone (susceptible to call stack limits).
|
||
|
(isArr ? arrayEach : baseForOwn)(value, function(subValue, key) {
|
||
|
assignValue(result, key, baseClone(subValue, isDeep, isFull, customizer, key, value, stack));
|
||
|
});
|
||
|
return (isFull && !isArr) ? copySymbols(value, result) : result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.create` without support for assigning
|
||
|
* properties to the created object.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} prototype The object to inherit from.
|
||
|
* @returns {Object} Returns the new object.
|
||
|
*/
|
||
|
function baseCreate(proto) {
|
||
|
return isObject(proto) ? objectCreate(proto) : {};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.forEach` without support for iteratee shorthands.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array|Object} collection The collection to iterate over.
|
||
|
* @param {Function} iteratee The function invoked per iteration.
|
||
|
* @returns {Array|Object} Returns `collection`.
|
||
|
*/
|
||
|
var baseEach = createBaseEach(baseForOwn);
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `baseForIn` and `baseForOwn` which iterates
|
||
|
* over `object` properties returned by `keysFunc` invoking `iteratee` for
|
||
|
* each property. Iteratee functions may exit iteration early by explicitly
|
||
|
* returning `false`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to iterate over.
|
||
|
* @param {Function} iteratee The function invoked per iteration.
|
||
|
* @param {Function} keysFunc The function to get the keys of `object`.
|
||
|
* @returns {Object} Returns `object`.
|
||
|
*/
|
||
|
var baseFor = createBaseFor();
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.forOwn` without support for iteratee shorthands.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to iterate over.
|
||
|
* @param {Function} iteratee The function invoked per iteration.
|
||
|
* @returns {Object} Returns `object`.
|
||
|
*/
|
||
|
function baseForOwn(object, iteratee) {
|
||
|
return object && baseFor(object, iteratee, keys);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.get` without support for default values.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @param {Array|string} path The path of the property to get.
|
||
|
* @returns {*} Returns the resolved value.
|
||
|
*/
|
||
|
function baseGet(object, path) {
|
||
|
path = isKey(path, object) ? [path + ''] : baseCastPath(path);
|
||
|
|
||
|
var index = 0,
|
||
|
length = path.length;
|
||
|
|
||
|
while (object != null && index < length) {
|
||
|
object = object[path[index++]];
|
||
|
}
|
||
|
return (index && index == length) ? object : undefined;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.has` without support for deep paths.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @param {Array|string} key The key to check.
|
||
|
* @returns {boolean} Returns `true` if `key` exists, else `false`.
|
||
|
*/
|
||
|
function baseHas(object, key) {
|
||
|
// Avoid a bug in IE 10-11 where objects with a [[Prototype]] of `null`,
|
||
|
// that are composed entirely of index properties, return `false` for
|
||
|
// `hasOwnProperty` checks of them.
|
||
|
return hasOwnProperty.call(object, key) ||
|
||
|
(typeof object == 'object' && key in object && getPrototypeOf(object) === null);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.hasIn` without support for deep paths.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @param {Array|string} key The key to check.
|
||
|
* @returns {boolean} Returns `true` if `key` exists, else `false`.
|
||
|
*/
|
||
|
function baseHasIn(object, key) {
|
||
|
return key in Object(object);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.isEqual` which supports partial comparisons
|
||
|
* and tracks traversed objects.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to compare.
|
||
|
* @param {*} other The other value to compare.
|
||
|
* @param {Function} [customizer] The function to customize comparisons.
|
||
|
* @param {boolean} [bitmask] The bitmask of comparison flags.
|
||
|
* The bitmask may be composed of the following flags:
|
||
|
* 1 - Unordered comparison
|
||
|
* 2 - Partial comparison
|
||
|
* @param {Object} [stack] Tracks traversed `value` and `other` objects.
|
||
|
* @returns {boolean} Returns `true` if the values are equivalent, else `false`.
|
||
|
*/
|
||
|
function baseIsEqual(value, other, customizer, bitmask, stack) {
|
||
|
if (value === other) {
|
||
|
return true;
|
||
|
}
|
||
|
if (value == null || other == null || (!isObject(value) && !isObjectLike(other))) {
|
||
|
return value !== value && other !== other;
|
||
|
}
|
||
|
return baseIsEqualDeep(value, other, baseIsEqual, customizer, bitmask, stack);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* A specialized version of `baseIsEqual` for arrays and objects which performs
|
||
|
* deep comparisons and tracks traversed objects enabling objects with circular
|
||
|
* references to be compared.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to compare.
|
||
|
* @param {Object} other The other object to compare.
|
||
|
* @param {Function} equalFunc The function to determine equivalents of values.
|
||
|
* @param {Function} [customizer] The function to customize comparisons.
|
||
|
* @param {number} [bitmask] The bitmask of comparison flags. See `baseIsEqual` for more details.
|
||
|
* @param {Object} [stack] Tracks traversed `object` and `other` objects.
|
||
|
* @returns {boolean} Returns `true` if the objects are equivalent, else `false`.
|
||
|
*/
|
||
|
function baseIsEqualDeep(object, other, equalFunc, customizer, bitmask, stack) {
|
||
|
var objIsArr = isArray(object),
|
||
|
othIsArr = isArray(other),
|
||
|
objTag = arrayTag,
|
||
|
othTag = arrayTag;
|
||
|
|
||
|
if (!objIsArr) {
|
||
|
objTag = getTag(object);
|
||
|
objTag = objTag == argsTag ? objectTag : objTag;
|
||
|
}
|
||
|
if (!othIsArr) {
|
||
|
othTag = getTag(other);
|
||
|
othTag = othTag == argsTag ? objectTag : othTag;
|
||
|
}
|
||
|
var objIsObj = objTag == objectTag && !isHostObject(object),
|
||
|
othIsObj = othTag == objectTag && !isHostObject(other),
|
||
|
isSameTag = objTag == othTag;
|
||
|
|
||
|
if (isSameTag && !objIsObj) {
|
||
|
stack || (stack = new Stack);
|
||
|
return (objIsArr || isTypedArray(object))
|
||
|
? equalArrays(object, other, equalFunc, customizer, bitmask, stack)
|
||
|
: equalByTag(object, other, objTag, equalFunc, customizer, bitmask, stack);
|
||
|
}
|
||
|
if (!(bitmask & PARTIAL_COMPARE_FLAG)) {
|
||
|
var objIsWrapped = objIsObj && hasOwnProperty.call(object, '__wrapped__'),
|
||
|
othIsWrapped = othIsObj && hasOwnProperty.call(other, '__wrapped__');
|
||
|
|
||
|
if (objIsWrapped || othIsWrapped) {
|
||
|
stack || (stack = new Stack);
|
||
|
return equalFunc(objIsWrapped ? object.value() : object, othIsWrapped ? other.value() : other, customizer, bitmask, stack);
|
||
|
}
|
||
|
}
|
||
|
if (!isSameTag) {
|
||
|
return false;
|
||
|
}
|
||
|
stack || (stack = new Stack);
|
||
|
return equalObjects(object, other, equalFunc, customizer, bitmask, stack);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.isMatch` without support for iteratee shorthands.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to inspect.
|
||
|
* @param {Object} source The object of property values to match.
|
||
|
* @param {Array} matchData The property names, values, and compare flags to match.
|
||
|
* @param {Function} [customizer] The function to customize comparisons.
|
||
|
* @returns {boolean} Returns `true` if `object` is a match, else `false`.
|
||
|
*/
|
||
|
function baseIsMatch(object, source, matchData, customizer) {
|
||
|
var index = matchData.length,
|
||
|
length = index,
|
||
|
noCustomizer = !customizer;
|
||
|
|
||
|
if (object == null) {
|
||
|
return !length;
|
||
|
}
|
||
|
object = Object(object);
|
||
|
while (index--) {
|
||
|
var data = matchData[index];
|
||
|
if ((noCustomizer && data[2])
|
||
|
? data[1] !== object[data[0]]
|
||
|
: !(data[0] in object)
|
||
|
) {
|
||
|
return false;
|
||
|
}
|
||
|
}
|
||
|
while (++index < length) {
|
||
|
data = matchData[index];
|
||
|
var key = data[0],
|
||
|
objValue = object[key],
|
||
|
srcValue = data[1];
|
||
|
|
||
|
if (noCustomizer && data[2]) {
|
||
|
if (objValue === undefined && !(key in object)) {
|
||
|
return false;
|
||
|
}
|
||
|
} else {
|
||
|
var stack = new Stack,
|
||
|
result = customizer ? customizer(objValue, srcValue, key, object, source, stack) : undefined;
|
||
|
|
||
|
if (!(result === undefined
|
||
|
? baseIsEqual(srcValue, objValue, customizer, UNORDERED_COMPARE_FLAG | PARTIAL_COMPARE_FLAG, stack)
|
||
|
: result
|
||
|
)) {
|
||
|
return false;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
return true;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.iteratee`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} [value=_.identity] The value to convert to an iteratee.
|
||
|
* @returns {Function} Returns the iteratee.
|
||
|
*/
|
||
|
function baseIteratee(value) {
|
||
|
var type = typeof value;
|
||
|
if (type == 'function') {
|
||
|
return value;
|
||
|
}
|
||
|
if (value == null) {
|
||
|
return identity;
|
||
|
}
|
||
|
if (type == 'object') {
|
||
|
return isArray(value)
|
||
|
? baseMatchesProperty(value[0], value[1])
|
||
|
: baseMatches(value);
|
||
|
}
|
||
|
return property(value);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.keys` which doesn't skip the constructor
|
||
|
* property of prototypes or treat sparse arrays as dense.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @returns {Array} Returns the array of property names.
|
||
|
*/
|
||
|
function baseKeys(object) {
|
||
|
return nativeKeys(Object(object));
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.map` without support for iteratee shorthands.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array|Object} collection The collection to iterate over.
|
||
|
* @param {Function} iteratee The function invoked per iteration.
|
||
|
* @returns {Array} Returns the new mapped array.
|
||
|
*/
|
||
|
function baseMap(collection, iteratee) {
|
||
|
var index = -1,
|
||
|
result = isArrayLike(collection) ? Array(collection.length) : [];
|
||
|
|
||
|
baseEach(collection, function(value, key, collection) {
|
||
|
result[++index] = iteratee(value, key, collection);
|
||
|
});
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.matches` which doesn't clone `source`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} source The object of property values to match.
|
||
|
* @returns {Function} Returns the new function.
|
||
|
*/
|
||
|
function baseMatches(source) {
|
||
|
var matchData = getMatchData(source);
|
||
|
if (matchData.length == 1 && matchData[0][2]) {
|
||
|
var key = matchData[0][0],
|
||
|
value = matchData[0][1];
|
||
|
|
||
|
return function(object) {
|
||
|
if (object == null) {
|
||
|
return false;
|
||
|
}
|
||
|
return object[key] === value &&
|
||
|
(value !== undefined || (key in Object(object)));
|
||
|
};
|
||
|
}
|
||
|
return function(object) {
|
||
|
return object === source || baseIsMatch(object, source, matchData);
|
||
|
};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.matchesProperty` which doesn't clone `srcValue`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {string} path The path of the property to get.
|
||
|
* @param {*} srcValue The value to match.
|
||
|
* @returns {Function} Returns the new function.
|
||
|
*/
|
||
|
function baseMatchesProperty(path, srcValue) {
|
||
|
return function(object) {
|
||
|
var objValue = get(object, path);
|
||
|
return (objValue === undefined && objValue === srcValue)
|
||
|
? hasIn(object, path)
|
||
|
: baseIsEqual(srcValue, objValue, undefined, UNORDERED_COMPARE_FLAG | PARTIAL_COMPARE_FLAG);
|
||
|
};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.property` without support for deep paths.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {string} key The key of the property to get.
|
||
|
* @returns {Function} Returns the new function.
|
||
|
*/
|
||
|
function baseProperty(key) {
|
||
|
return function(object) {
|
||
|
return object == null ? undefined : object[key];
|
||
|
};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* A specialized version of `baseProperty` which supports deep paths.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array|string} path The path of the property to get.
|
||
|
* @returns {Function} Returns the new function.
|
||
|
*/
|
||
|
function basePropertyDeep(path) {
|
||
|
return function(object) {
|
||
|
return baseGet(object, path);
|
||
|
};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.range` and `_.rangeRight` which doesn't
|
||
|
* coerce arguments to numbers.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {number} start The start of the range.
|
||
|
* @param {number} end The end of the range.
|
||
|
* @param {number} step The value to increment or decrement by.
|
||
|
* @param {boolean} [fromRight] Specify iterating from right to left.
|
||
|
* @returns {Array} Returns the new array of numbers.
|
||
|
*/
|
||
|
function baseRange(start, end, step, fromRight) {
|
||
|
var index = -1,
|
||
|
length = nativeMax(nativeCeil((end - start) / (step || 1)), 0),
|
||
|
result = Array(length);
|
||
|
|
||
|
while (length--) {
|
||
|
result[fromRight ? length : ++index] = start;
|
||
|
start += step;
|
||
|
}
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The base implementation of `_.slice` without an iteratee call guard.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to slice.
|
||
|
* @param {number} [start=0] The start position.
|
||
|
* @param {number} [end=array.length] The end position.
|
||
|
* @returns {Array} Returns the slice of `array`.
|
||
|
*/
|
||
|
function baseSlice(array, start, end) {
|
||
|
var index = -1,
|
||
|
length = array.length;
|
||
|
|
||
|
if (start < 0) {
|
||
|
start = -start > length ? 0 : (length + start);
|
||
|
}
|
||
|
end = end > length ? length : end;
|
||
|
if (end < 0) {
|
||
|
end += length;
|
||
|
}
|
||
|
length = start > end ? 0 : ((end - start) >>> 0);
|
||
|
start >>>= 0;
|
||
|
|
||
|
var result = Array(length);
|
||
|
while (++index < length) {
|
||
|
result[index] = array[index + start];
|
||
|
}
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a clone of `buffer`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Buffer} buffer The buffer to clone.
|
||
|
* @param {boolean} [isDeep] Specify a deep clone.
|
||
|
* @returns {Buffer} Returns the cloned buffer.
|
||
|
*/
|
||
|
function cloneBuffer(buffer, isDeep) {
|
||
|
if (isDeep) {
|
||
|
return buffer.slice();
|
||
|
}
|
||
|
var result = new buffer.constructor(buffer.length);
|
||
|
buffer.copy(result);
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a clone of `arrayBuffer`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {ArrayBuffer} arrayBuffer The array buffer to clone.
|
||
|
* @returns {ArrayBuffer} Returns the cloned array buffer.
|
||
|
*/
|
||
|
function cloneArrayBuffer(arrayBuffer) {
|
||
|
var result = new arrayBuffer.constructor(arrayBuffer.byteLength);
|
||
|
new Uint8Array(result).set(new Uint8Array(arrayBuffer));
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a clone of `map`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} map The map to clone.
|
||
|
* @returns {Object} Returns the cloned map.
|
||
|
*/
|
||
|
function cloneMap(map) {
|
||
|
return arrayReduce(mapToArray(map), addMapEntry, new map.constructor);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a clone of `regexp`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} regexp The regexp to clone.
|
||
|
* @returns {Object} Returns the cloned regexp.
|
||
|
*/
|
||
|
function cloneRegExp(regexp) {
|
||
|
var result = new regexp.constructor(regexp.source, reFlags.exec(regexp));
|
||
|
result.lastIndex = regexp.lastIndex;
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a clone of `set`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} set The set to clone.
|
||
|
* @returns {Object} Returns the cloned set.
|
||
|
*/
|
||
|
function cloneSet(set) {
|
||
|
return arrayReduce(setToArray(set), addSetEntry, new set.constructor);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a clone of the `symbol` object.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} symbol The symbol object to clone.
|
||
|
* @returns {Object} Returns the cloned symbol object.
|
||
|
*/
|
||
|
function cloneSymbol(symbol) {
|
||
|
return symbolValueOf ? Object(symbolValueOf.call(symbol)) : {};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a clone of `typedArray`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} typedArray The typed array to clone.
|
||
|
* @param {boolean} [isDeep] Specify a deep clone.
|
||
|
* @returns {Object} Returns the cloned typed array.
|
||
|
*/
|
||
|
function cloneTypedArray(typedArray, isDeep) {
|
||
|
var buffer = isDeep ? cloneArrayBuffer(typedArray.buffer) : typedArray.buffer;
|
||
|
return new typedArray.constructor(buffer, typedArray.byteOffset, typedArray.length);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Copies the values of `source` to `array`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} source The array to copy values from.
|
||
|
* @param {Array} [array=[]] The array to copy values to.
|
||
|
* @returns {Array} Returns `array`.
|
||
|
*/
|
||
|
function copyArray(source, array) {
|
||
|
var index = -1,
|
||
|
length = source.length;
|
||
|
|
||
|
array || (array = Array(length));
|
||
|
while (++index < length) {
|
||
|
array[index] = source[index];
|
||
|
}
|
||
|
return array;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Copies properties of `source` to `object`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} source The object to copy properties from.
|
||
|
* @param {Array} props The property names to copy.
|
||
|
* @param {Object} [object={}] The object to copy properties to.
|
||
|
* @returns {Object} Returns `object`.
|
||
|
*/
|
||
|
function copyObject(source, props, object) {
|
||
|
return copyObjectWith(source, props, object);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* This function is like `copyObject` except that it accepts a function to
|
||
|
* customize copied values.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} source The object to copy properties from.
|
||
|
* @param {Array} props The property names to copy.
|
||
|
* @param {Object} [object={}] The object to copy properties to.
|
||
|
* @param {Function} [customizer] The function to customize copied values.
|
||
|
* @returns {Object} Returns `object`.
|
||
|
*/
|
||
|
function copyObjectWith(source, props, object, customizer) {
|
||
|
object || (object = {});
|
||
|
|
||
|
var index = -1,
|
||
|
length = props.length;
|
||
|
|
||
|
while (++index < length) {
|
||
|
var key = props[index];
|
||
|
|
||
|
var newValue = customizer
|
||
|
? customizer(object[key], source[key], key, object, source)
|
||
|
: source[key];
|
||
|
|
||
|
assignValue(object, key, newValue);
|
||
|
}
|
||
|
return object;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Copies own symbol properties of `source` to `object`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} source The object to copy symbols from.
|
||
|
* @param {Object} [object={}] The object to copy symbols to.
|
||
|
* @returns {Object} Returns `object`.
|
||
|
*/
|
||
|
function copySymbols(source, object) {
|
||
|
return copyObject(source, getSymbols(source), object);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a `baseEach` or `baseEachRight` function.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Function} eachFunc The function to iterate over a collection.
|
||
|
* @param {boolean} [fromRight] Specify iterating from right to left.
|
||
|
* @returns {Function} Returns the new base function.
|
||
|
*/
|
||
|
function createBaseEach(eachFunc, fromRight) {
|
||
|
return function(collection, iteratee) {
|
||
|
if (collection == null) {
|
||
|
return collection;
|
||
|
}
|
||
|
if (!isArrayLike(collection)) {
|
||
|
return eachFunc(collection, iteratee);
|
||
|
}
|
||
|
var length = collection.length,
|
||
|
index = fromRight ? length : -1,
|
||
|
iterable = Object(collection);
|
||
|
|
||
|
while ((fromRight ? index-- : ++index < length)) {
|
||
|
if (iteratee(iterable[index], index, iterable) === false) {
|
||
|
break;
|
||
|
}
|
||
|
}
|
||
|
return collection;
|
||
|
};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a base function for methods like `_.forIn`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {boolean} [fromRight] Specify iterating from right to left.
|
||
|
* @returns {Function} Returns the new base function.
|
||
|
*/
|
||
|
function createBaseFor(fromRight) {
|
||
|
return function(object, iteratee, keysFunc) {
|
||
|
var index = -1,
|
||
|
iterable = Object(object),
|
||
|
props = keysFunc(object),
|
||
|
length = props.length;
|
||
|
|
||
|
while (length--) {
|
||
|
var key = props[fromRight ? length : ++index];
|
||
|
if (iteratee(iterable[key], key, iterable) === false) {
|
||
|
break;
|
||
|
}
|
||
|
}
|
||
|
return object;
|
||
|
};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a `_.range` or `_.rangeRight` function.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {boolean} [fromRight] Specify iterating from right to left.
|
||
|
* @returns {Function} Returns the new range function.
|
||
|
*/
|
||
|
function createRange(fromRight) {
|
||
|
return function(start, end, step) {
|
||
|
if (step && typeof step != 'number' && isIterateeCall(start, end, step)) {
|
||
|
end = step = undefined;
|
||
|
}
|
||
|
// Ensure the sign of `-0` is preserved.
|
||
|
start = toNumber(start);
|
||
|
start = start === start ? start : 0;
|
||
|
if (end === undefined) {
|
||
|
end = start;
|
||
|
start = 0;
|
||
|
} else {
|
||
|
end = toNumber(end) || 0;
|
||
|
}
|
||
|
step = step === undefined ? (start < end ? 1 : -1) : (toNumber(step) || 0);
|
||
|
return baseRange(start, end, step, fromRight);
|
||
|
};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* A specialized version of `baseIsEqualDeep` for arrays with support for
|
||
|
* partial deep comparisons.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to compare.
|
||
|
* @param {Array} other The other array to compare.
|
||
|
* @param {Function} equalFunc The function to determine equivalents of values.
|
||
|
* @param {Function} customizer The function to customize comparisons.
|
||
|
* @param {number} bitmask The bitmask of comparison flags. See `baseIsEqual` for more details.
|
||
|
* @param {Object} stack Tracks traversed `array` and `other` objects.
|
||
|
* @returns {boolean} Returns `true` if the arrays are equivalent, else `false`.
|
||
|
*/
|
||
|
function equalArrays(array, other, equalFunc, customizer, bitmask, stack) {
|
||
|
var index = -1,
|
||
|
isPartial = bitmask & PARTIAL_COMPARE_FLAG,
|
||
|
isUnordered = bitmask & UNORDERED_COMPARE_FLAG,
|
||
|
arrLength = array.length,
|
||
|
othLength = other.length;
|
||
|
|
||
|
if (arrLength != othLength && !(isPartial && othLength > arrLength)) {
|
||
|
return false;
|
||
|
}
|
||
|
// Assume cyclic values are equal.
|
||
|
var stacked = stack.get(array);
|
||
|
if (stacked) {
|
||
|
return stacked == other;
|
||
|
}
|
||
|
var result = true;
|
||
|
stack.set(array, other);
|
||
|
|
||
|
// Ignore non-index properties.
|
||
|
while (++index < arrLength) {
|
||
|
var arrValue = array[index],
|
||
|
othValue = other[index];
|
||
|
|
||
|
if (customizer) {
|
||
|
var compared = isPartial
|
||
|
? customizer(othValue, arrValue, index, other, array, stack)
|
||
|
: customizer(arrValue, othValue, index, array, other, stack);
|
||
|
}
|
||
|
if (compared !== undefined) {
|
||
|
if (compared) {
|
||
|
continue;
|
||
|
}
|
||
|
result = false;
|
||
|
break;
|
||
|
}
|
||
|
// Recursively compare arrays (susceptible to call stack limits).
|
||
|
if (isUnordered) {
|
||
|
if (!arraySome(other, function(othValue) {
|
||
|
return arrValue === othValue || equalFunc(arrValue, othValue, customizer, bitmask, stack);
|
||
|
})) {
|
||
|
result = false;
|
||
|
break;
|
||
|
}
|
||
|
} else if (!(arrValue === othValue || equalFunc(arrValue, othValue, customizer, bitmask, stack))) {
|
||
|
result = false;
|
||
|
break;
|
||
|
}
|
||
|
}
|
||
|
stack['delete'](array);
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* A specialized version of `baseIsEqualDeep` for comparing objects of
|
||
|
* the same `toStringTag`.
|
||
|
*
|
||
|
* **Note:** This function only supports comparing values with tags of
|
||
|
* `Boolean`, `Date`, `Error`, `Number`, `RegExp`, or `String`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to compare.
|
||
|
* @param {Object} other The other object to compare.
|
||
|
* @param {string} tag The `toStringTag` of the objects to compare.
|
||
|
* @param {Function} equalFunc The function to determine equivalents of values.
|
||
|
* @param {Function} customizer The function to customize comparisons.
|
||
|
* @param {number} bitmask The bitmask of comparison flags. See `baseIsEqual` for more details.
|
||
|
* @param {Object} stack Tracks traversed `object` and `other` objects.
|
||
|
* @returns {boolean} Returns `true` if the objects are equivalent, else `false`.
|
||
|
*/
|
||
|
function equalByTag(object, other, tag, equalFunc, customizer, bitmask, stack) {
|
||
|
switch (tag) {
|
||
|
case arrayBufferTag:
|
||
|
if ((object.byteLength != other.byteLength) ||
|
||
|
!equalFunc(new Uint8Array(object), new Uint8Array(other))) {
|
||
|
return false;
|
||
|
}
|
||
|
return true;
|
||
|
|
||
|
case boolTag:
|
||
|
case dateTag:
|
||
|
// Coerce dates and booleans to numbers, dates to milliseconds and booleans
|
||
|
// to `1` or `0` treating invalid dates coerced to `NaN` as not equal.
|
||
|
return +object == +other;
|
||
|
|
||
|
case errorTag:
|
||
|
return object.name == other.name && object.message == other.message;
|
||
|
|
||
|
case numberTag:
|
||
|
// Treat `NaN` vs. `NaN` as equal.
|
||
|
return (object != +object) ? other != +other : object == +other;
|
||
|
|
||
|
case regexpTag:
|
||
|
case stringTag:
|
||
|
// Coerce regexes to strings and treat strings primitives and string
|
||
|
// objects as equal. See https://es5.github.io/#x15.10.6.4 for more details.
|
||
|
return object == (other + '');
|
||
|
|
||
|
case mapTag:
|
||
|
var convert = mapToArray;
|
||
|
|
||
|
case setTag:
|
||
|
var isPartial = bitmask & PARTIAL_COMPARE_FLAG;
|
||
|
convert || (convert = setToArray);
|
||
|
|
||
|
if (object.size != other.size && !isPartial) {
|
||
|
return false;
|
||
|
}
|
||
|
// Assume cyclic values are equal.
|
||
|
var stacked = stack.get(object);
|
||
|
if (stacked) {
|
||
|
return stacked == other;
|
||
|
}
|
||
|
// Recursively compare objects (susceptible to call stack limits).
|
||
|
return equalArrays(convert(object), convert(other), equalFunc, customizer, bitmask | UNORDERED_COMPARE_FLAG, stack.set(object, other));
|
||
|
|
||
|
case symbolTag:
|
||
|
if (symbolValueOf) {
|
||
|
return symbolValueOf.call(object) == symbolValueOf.call(other);
|
||
|
}
|
||
|
}
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* A specialized version of `baseIsEqualDeep` for objects with support for
|
||
|
* partial deep comparisons.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to compare.
|
||
|
* @param {Object} other The other object to compare.
|
||
|
* @param {Function} equalFunc The function to determine equivalents of values.
|
||
|
* @param {Function} customizer The function to customize comparisons.
|
||
|
* @param {number} bitmask The bitmask of comparison flags. See `baseIsEqual` for more details.
|
||
|
* @param {Object} stack Tracks traversed `object` and `other` objects.
|
||
|
* @returns {boolean} Returns `true` if the objects are equivalent, else `false`.
|
||
|
*/
|
||
|
function equalObjects(object, other, equalFunc, customizer, bitmask, stack) {
|
||
|
var isPartial = bitmask & PARTIAL_COMPARE_FLAG,
|
||
|
objProps = keys(object),
|
||
|
objLength = objProps.length,
|
||
|
othProps = keys(other),
|
||
|
othLength = othProps.length;
|
||
|
|
||
|
if (objLength != othLength && !isPartial) {
|
||
|
return false;
|
||
|
}
|
||
|
var index = objLength;
|
||
|
while (index--) {
|
||
|
var key = objProps[index];
|
||
|
if (!(isPartial ? key in other : baseHas(other, key))) {
|
||
|
return false;
|
||
|
}
|
||
|
}
|
||
|
// Assume cyclic values are equal.
|
||
|
var stacked = stack.get(object);
|
||
|
if (stacked) {
|
||
|
return stacked == other;
|
||
|
}
|
||
|
var result = true;
|
||
|
stack.set(object, other);
|
||
|
|
||
|
var skipCtor = isPartial;
|
||
|
while (++index < objLength) {
|
||
|
key = objProps[index];
|
||
|
var objValue = object[key],
|
||
|
othValue = other[key];
|
||
|
|
||
|
if (customizer) {
|
||
|
var compared = isPartial
|
||
|
? customizer(othValue, objValue, key, other, object, stack)
|
||
|
: customizer(objValue, othValue, key, object, other, stack);
|
||
|
}
|
||
|
// Recursively compare objects (susceptible to call stack limits).
|
||
|
if (!(compared === undefined
|
||
|
? (objValue === othValue || equalFunc(objValue, othValue, customizer, bitmask, stack))
|
||
|
: compared
|
||
|
)) {
|
||
|
result = false;
|
||
|
break;
|
||
|
}
|
||
|
skipCtor || (skipCtor = key == 'constructor');
|
||
|
}
|
||
|
if (result && !skipCtor) {
|
||
|
var objCtor = object.constructor,
|
||
|
othCtor = other.constructor;
|
||
|
|
||
|
// Non `Object` object instances with different constructors are not equal.
|
||
|
if (objCtor != othCtor &&
|
||
|
('constructor' in object && 'constructor' in other) &&
|
||
|
!(typeof objCtor == 'function' && objCtor instanceof objCtor &&
|
||
|
typeof othCtor == 'function' && othCtor instanceof othCtor)) {
|
||
|
result = false;
|
||
|
}
|
||
|
}
|
||
|
stack['delete'](object);
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Gets the appropriate "iteratee" function. If the `_.iteratee` method is
|
||
|
* customized this function returns the custom method, otherwise it returns
|
||
|
* `baseIteratee`. If arguments are provided the chosen function is invoked
|
||
|
* with them and its result is returned.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} [value] The value to convert to an iteratee.
|
||
|
* @param {number} [arity] The arity of the created iteratee.
|
||
|
* @returns {Function} Returns the chosen function or its result.
|
||
|
*/
|
||
|
function getIteratee() {
|
||
|
var result = lodash.iteratee || iteratee;
|
||
|
result = result === iteratee ? baseIteratee : result;
|
||
|
return arguments.length ? result(arguments[0], arguments[1]) : result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Gets the "length" property value of `object`.
|
||
|
*
|
||
|
* **Note:** This function is used to avoid a [JIT bug](https://bugs.webkit.org/show_bug.cgi?id=142792)
|
||
|
* that affects Safari on at least iOS 8.1-8.3 ARM64.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @returns {*} Returns the "length" value.
|
||
|
*/
|
||
|
var getLength = baseProperty('length');
|
||
|
|
||
|
/**
|
||
|
* Gets the property names, values, and compare flags of `object`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @returns {Array} Returns the match data of `object`.
|
||
|
*/
|
||
|
function getMatchData(object) {
|
||
|
var result = toPairs(object),
|
||
|
length = result.length;
|
||
|
|
||
|
while (length--) {
|
||
|
result[length][2] = isStrictComparable(result[length][1]);
|
||
|
}
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Gets the native function at `key` of `object`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @param {string} key The key of the method to get.
|
||
|
* @returns {*} Returns the function if it's native, else `undefined`.
|
||
|
*/
|
||
|
function getNative(object, key) {
|
||
|
var value = object[key];
|
||
|
return isNative(value) ? value : undefined;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates an array of the own symbol properties of `object`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @returns {Array} Returns the array of symbols.
|
||
|
*/
|
||
|
var getSymbols = getOwnPropertySymbols || function() {
|
||
|
return [];
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* Gets the `toStringTag` of `value`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to query.
|
||
|
* @returns {string} Returns the `toStringTag`.
|
||
|
*/
|
||
|
function getTag(value) {
|
||
|
return objectToString.call(value);
|
||
|
}
|
||
|
|
||
|
// Fallback for IE 11 providing `toStringTag` values for maps, sets, and weakmaps.
|
||
|
if ((Map && getTag(new Map) != mapTag) ||
|
||
|
(Set && getTag(new Set) != setTag) ||
|
||
|
(WeakMap && getTag(new WeakMap) != weakMapTag)) {
|
||
|
getTag = function(value) {
|
||
|
var result = objectToString.call(value),
|
||
|
Ctor = result == objectTag ? value.constructor : null,
|
||
|
ctorString = typeof Ctor == 'function' ? funcToString.call(Ctor) : '';
|
||
|
|
||
|
if (ctorString) {
|
||
|
switch (ctorString) {
|
||
|
case mapCtorString: return mapTag;
|
||
|
case setCtorString: return setTag;
|
||
|
case weakMapCtorString: return weakMapTag;
|
||
|
}
|
||
|
}
|
||
|
return result;
|
||
|
};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `path` exists on `object`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @param {Array|string} path The path to check.
|
||
|
* @param {Function} hasFunc The function to check properties.
|
||
|
* @returns {boolean} Returns `true` if `path` exists, else `false`.
|
||
|
*/
|
||
|
function hasPath(object, path, hasFunc) {
|
||
|
if (object == null) {
|
||
|
return false;
|
||
|
}
|
||
|
var result = hasFunc(object, path);
|
||
|
if (!result && !isKey(path)) {
|
||
|
path = baseCastPath(path);
|
||
|
object = parent(object, path);
|
||
|
if (object != null) {
|
||
|
path = last(path);
|
||
|
result = hasFunc(object, path);
|
||
|
}
|
||
|
}
|
||
|
var length = object ? object.length : undefined;
|
||
|
return result || (
|
||
|
!!length && isLength(length) && isIndex(path, length) &&
|
||
|
(isArray(object) || isString(object) || isArguments(object))
|
||
|
);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Initializes an array clone.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Array} array The array to clone.
|
||
|
* @returns {Array} Returns the initialized clone.
|
||
|
*/
|
||
|
function initCloneArray(array) {
|
||
|
var length = array.length,
|
||
|
result = array.constructor(length);
|
||
|
|
||
|
// Add properties assigned by `RegExp#exec`.
|
||
|
if (length && typeof array[0] == 'string' && hasOwnProperty.call(array, 'index')) {
|
||
|
result.index = array.index;
|
||
|
result.input = array.input;
|
||
|
}
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Initializes an object clone.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to clone.
|
||
|
* @returns {Object} Returns the initialized clone.
|
||
|
*/
|
||
|
function initCloneObject(object) {
|
||
|
return (typeof object.constructor == 'function' && !isPrototype(object))
|
||
|
? baseCreate(getPrototypeOf(object))
|
||
|
: {};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Initializes an object clone based on its `toStringTag`.
|
||
|
*
|
||
|
* **Note:** This function only supports cloning values with tags of
|
||
|
* `Boolean`, `Date`, `Error`, `Number`, `RegExp`, or `String`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to clone.
|
||
|
* @param {string} tag The `toStringTag` of the object to clone.
|
||
|
* @param {boolean} [isDeep] Specify a deep clone.
|
||
|
* @returns {Object} Returns the initialized clone.
|
||
|
*/
|
||
|
function initCloneByTag(object, tag, isDeep) {
|
||
|
var Ctor = object.constructor;
|
||
|
switch (tag) {
|
||
|
case arrayBufferTag:
|
||
|
return cloneArrayBuffer(object);
|
||
|
|
||
|
case boolTag:
|
||
|
case dateTag:
|
||
|
return new Ctor(+object);
|
||
|
|
||
|
case float32Tag: case float64Tag:
|
||
|
case int8Tag: case int16Tag: case int32Tag:
|
||
|
case uint8Tag: case uint8ClampedTag: case uint16Tag: case uint32Tag:
|
||
|
return cloneTypedArray(object, isDeep);
|
||
|
|
||
|
case mapTag:
|
||
|
return cloneMap(object);
|
||
|
|
||
|
case numberTag:
|
||
|
case stringTag:
|
||
|
return new Ctor(object);
|
||
|
|
||
|
case regexpTag:
|
||
|
return cloneRegExp(object);
|
||
|
|
||
|
case setTag:
|
||
|
return cloneSet(object);
|
||
|
|
||
|
case symbolTag:
|
||
|
return cloneSymbol(object);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates an array of index keys for `object` values of arrays,
|
||
|
* `arguments` objects, and strings, otherwise `null` is returned.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @returns {Array|null} Returns index keys, else `null`.
|
||
|
*/
|
||
|
function indexKeys(object) {
|
||
|
var length = object ? object.length : undefined;
|
||
|
if (isLength(length) &&
|
||
|
(isArray(object) || isString(object) || isArguments(object))) {
|
||
|
return baseTimes(length, String);
|
||
|
}
|
||
|
return null;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if the given arguments are from an iteratee call.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The potential iteratee value argument.
|
||
|
* @param {*} index The potential iteratee index or key argument.
|
||
|
* @param {*} object The potential iteratee object argument.
|
||
|
* @returns {boolean} Returns `true` if the arguments are from an iteratee call, else `false`.
|
||
|
*/
|
||
|
function isIterateeCall(value, index, object) {
|
||
|
if (!isObject(object)) {
|
||
|
return false;
|
||
|
}
|
||
|
var type = typeof index;
|
||
|
if (type == 'number'
|
||
|
? (isArrayLike(object) && isIndex(index, object.length))
|
||
|
: (type == 'string' && index in object)) {
|
||
|
return eq(object[index], value);
|
||
|
}
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is a property name and not a property path.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to check.
|
||
|
* @param {Object} [object] The object to query keys on.
|
||
|
* @returns {boolean} Returns `true` if `value` is a property name, else `false`.
|
||
|
*/
|
||
|
function isKey(value, object) {
|
||
|
if (typeof value == 'number') {
|
||
|
return true;
|
||
|
}
|
||
|
return !isArray(value) &&
|
||
|
(reIsPlainProp.test(value) || !reIsDeepProp.test(value) ||
|
||
|
(object != null && value in Object(object)));
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is suitable for use as unique object key.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is suitable, else `false`.
|
||
|
*/
|
||
|
function isKeyable(value) {
|
||
|
var type = typeof value;
|
||
|
return type == 'number' || type == 'boolean' ||
|
||
|
(type == 'string' && value != '__proto__') || value == null;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is likely a prototype object.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is a prototype, else `false`.
|
||
|
*/
|
||
|
function isPrototype(value) {
|
||
|
var Ctor = value && value.constructor,
|
||
|
proto = (typeof Ctor == 'function' && Ctor.prototype) || objectProto;
|
||
|
|
||
|
return value === proto;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is suitable for strict equality comparisons, i.e. `===`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` if suitable for strict
|
||
|
* equality comparisons, else `false`.
|
||
|
*/
|
||
|
function isStrictComparable(value) {
|
||
|
return value === value && !isObject(value);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Gets the parent value at `path` of `object`.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {Object} object The object to query.
|
||
|
* @param {Array} path The path to get the parent value of.
|
||
|
* @returns {*} Returns the parent value.
|
||
|
*/
|
||
|
function parent(object, path) {
|
||
|
return path.length == 1 ? object : get(object, baseSlice(path, 0, -1));
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Converts `string` to a property path array.
|
||
|
*
|
||
|
* @private
|
||
|
* @param {string} string The string to convert.
|
||
|
* @returns {Array} Returns the property path array.
|
||
|
*/
|
||
|
function stringToPath(string) {
|
||
|
var result = [];
|
||
|
toString(string).replace(rePropName, function(match, number, quote, string) {
|
||
|
result.push(quote ? string.replace(reEscapeChar, '$1') : (number || match));
|
||
|
});
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Gets the last element of `array`.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Array
|
||
|
* @param {Array} array The array to query.
|
||
|
* @returns {*} Returns the last element of `array`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.last([1, 2, 3]);
|
||
|
* // => 3
|
||
|
*/
|
||
|
function last(array) {
|
||
|
var length = array ? array.length : 0;
|
||
|
return length ? array[length - 1] : undefined;
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Iterates over elements of `collection` invoking `iteratee` for each element.
|
||
|
* The iteratee is invoked with three arguments: (value, index|key, collection).
|
||
|
* Iteratee functions may exit iteration early by explicitly returning `false`.
|
||
|
*
|
||
|
* **Note:** As with other "Collections" methods, objects with a "length" property
|
||
|
* are iterated like arrays. To avoid this behavior use `_.forIn` or `_.forOwn`
|
||
|
* for object iteration.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @alias each
|
||
|
* @category Collection
|
||
|
* @param {Array|Object} collection The collection to iterate over.
|
||
|
* @param {Function} [iteratee=_.identity] The function invoked per iteration.
|
||
|
* @returns {Array|Object} Returns `collection`.
|
||
|
* @example
|
||
|
*
|
||
|
* _([1, 2]).forEach(function(value) {
|
||
|
* console.log(value);
|
||
|
* });
|
||
|
* // => logs `1` then `2`
|
||
|
*
|
||
|
* _.forEach({ 'a': 1, 'b': 2 }, function(value, key) {
|
||
|
* console.log(key);
|
||
|
* });
|
||
|
* // => logs 'a' then 'b' (iteration order is not guaranteed)
|
||
|
*/
|
||
|
function forEach(collection, iteratee) {
|
||
|
return (typeof iteratee == 'function' && isArray(collection))
|
||
|
? arrayEach(collection, iteratee)
|
||
|
: baseEach(collection, baseCastFunction(iteratee));
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates an array of values by running each element in `collection` through
|
||
|
* `iteratee`. The iteratee is invoked with three arguments:
|
||
|
* (value, index|key, collection).
|
||
|
*
|
||
|
* Many lodash methods are guarded to work as iteratees for methods like
|
||
|
* `_.every`, `_.filter`, `_.map`, `_.mapValues`, `_.reject`, and `_.some`.
|
||
|
*
|
||
|
* The guarded methods are:
|
||
|
* `ary`, `curry`, `curryRight`, `drop`, `dropRight`, `every`, `fill`,
|
||
|
* `invert`, `parseInt`, `random`, `range`, `rangeRight`, `slice`, `some`,
|
||
|
* `sortBy`, `take`, `takeRight`, `template`, `trim`, `trimEnd`, `trimStart`,
|
||
|
* and `words`
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Collection
|
||
|
* @param {Array|Object} collection The collection to iterate over.
|
||
|
* @param {Function|Object|string} [iteratee=_.identity] The function invoked per iteration.
|
||
|
* @returns {Array} Returns the new mapped array.
|
||
|
* @example
|
||
|
*
|
||
|
* function square(n) {
|
||
|
* return n * n;
|
||
|
* }
|
||
|
*
|
||
|
* _.map([4, 8], square);
|
||
|
* // => [16, 64]
|
||
|
*
|
||
|
* _.map({ 'a': 4, 'b': 8 }, square);
|
||
|
* // => [16, 64] (iteration order is not guaranteed)
|
||
|
*
|
||
|
* var users = [
|
||
|
* { 'user': 'barney' },
|
||
|
* { 'user': 'fred' }
|
||
|
* ];
|
||
|
*
|
||
|
* // The `_.property` iteratee shorthand.
|
||
|
* _.map(users, 'user');
|
||
|
* // => ['barney', 'fred']
|
||
|
*/
|
||
|
function map(collection, iteratee) {
|
||
|
var func = isArray(collection) ? arrayMap : baseMap;
|
||
|
return func(collection, getIteratee(iteratee, 3));
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Performs a [`SameValueZero`](http://ecma-international.org/ecma-262/6.0/#sec-samevaluezero)
|
||
|
* comparison between two values to determine if they are equivalent.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to compare.
|
||
|
* @param {*} other The other value to compare.
|
||
|
* @returns {boolean} Returns `true` if the values are equivalent, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* var object = { 'user': 'fred' };
|
||
|
* var other = { 'user': 'fred' };
|
||
|
*
|
||
|
* _.eq(object, object);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.eq(object, other);
|
||
|
* // => false
|
||
|
*
|
||
|
* _.eq('a', 'a');
|
||
|
* // => true
|
||
|
*
|
||
|
* _.eq('a', Object('a'));
|
||
|
* // => false
|
||
|
*
|
||
|
* _.eq(NaN, NaN);
|
||
|
* // => true
|
||
|
*/
|
||
|
function eq(value, other) {
|
||
|
return value === other || (value !== value && other !== other);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is likely an `arguments` object.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isArguments(function() { return arguments; }());
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isArguments([1, 2, 3]);
|
||
|
* // => false
|
||
|
*/
|
||
|
function isArguments(value) {
|
||
|
// Safari 8.1 incorrectly makes `arguments.callee` enumerable in strict mode.
|
||
|
return isArrayLikeObject(value) && hasOwnProperty.call(value, 'callee') &&
|
||
|
(!propertyIsEnumerable.call(value, 'callee') || objectToString.call(value) == argsTag);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is classified as an `Array` object.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @type {Function}
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isArray([1, 2, 3]);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isArray(document.body.children);
|
||
|
* // => false
|
||
|
*
|
||
|
* _.isArray('abc');
|
||
|
* // => false
|
||
|
*
|
||
|
* _.isArray(_.noop);
|
||
|
* // => false
|
||
|
*/
|
||
|
var isArray = Array.isArray;
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is array-like. A value is considered array-like if it's
|
||
|
* not a function and has a `value.length` that's an integer greater than or
|
||
|
* equal to `0` and less than or equal to `Number.MAX_SAFE_INTEGER`.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is array-like, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isArrayLike([1, 2, 3]);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isArrayLike(document.body.children);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isArrayLike('abc');
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isArrayLike(_.noop);
|
||
|
* // => false
|
||
|
*/
|
||
|
function isArrayLike(value) {
|
||
|
return value != null && isLength(getLength(value)) && !isFunction(value);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* This method is like `_.isArrayLike` except that it also checks if `value`
|
||
|
* is an object.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is an array-like object, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isArrayLikeObject([1, 2, 3]);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isArrayLikeObject(document.body.children);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isArrayLikeObject('abc');
|
||
|
* // => false
|
||
|
*
|
||
|
* _.isArrayLikeObject(_.noop);
|
||
|
* // => false
|
||
|
*/
|
||
|
function isArrayLikeObject(value) {
|
||
|
return isObjectLike(value) && isArrayLike(value);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is a buffer.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is a buffer, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isBuffer(new Buffer(2));
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isBuffer(new Uint8Array(2));
|
||
|
* // => false
|
||
|
*/
|
||
|
var isBuffer = !Buffer ? constant(false) : function(value) {
|
||
|
return value instanceof Buffer;
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is classified as a `Function` object.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isFunction(_);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isFunction(/abc/);
|
||
|
* // => false
|
||
|
*/
|
||
|
function isFunction(value) {
|
||
|
// The use of `Object#toString` avoids issues with the `typeof` operator
|
||
|
// in Safari 8 which returns 'object' for typed array and weak map constructors,
|
||
|
// and PhantomJS 1.9 which returns 'function' for `NodeList` instances.
|
||
|
var tag = isObject(value) ? objectToString.call(value) : '';
|
||
|
return tag == funcTag || tag == genTag;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is a valid array-like length.
|
||
|
*
|
||
|
* **Note:** This function is loosely based on [`ToLength`](http://ecma-international.org/ecma-262/6.0/#sec-tolength).
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is a valid length, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isLength(3);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isLength(Number.MIN_VALUE);
|
||
|
* // => false
|
||
|
*
|
||
|
* _.isLength(Infinity);
|
||
|
* // => false
|
||
|
*
|
||
|
* _.isLength('3');
|
||
|
* // => false
|
||
|
*/
|
||
|
function isLength(value) {
|
||
|
return typeof value == 'number' &&
|
||
|
value > -1 && value % 1 == 0 && value <= MAX_SAFE_INTEGER;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is the [language type](https://es5.github.io/#x8) of `Object`.
|
||
|
* (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`)
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is an object, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isObject({});
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isObject([1, 2, 3]);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isObject(_.noop);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isObject(null);
|
||
|
* // => false
|
||
|
*/
|
||
|
function isObject(value) {
|
||
|
var type = typeof value;
|
||
|
return !!value && (type == 'object' || type == 'function');
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is object-like. A value is object-like if it's not `null`
|
||
|
* and has a `typeof` result of "object".
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is object-like, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isObjectLike({});
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isObjectLike([1, 2, 3]);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isObjectLike(_.noop);
|
||
|
* // => false
|
||
|
*
|
||
|
* _.isObjectLike(null);
|
||
|
* // => false
|
||
|
*/
|
||
|
function isObjectLike(value) {
|
||
|
return !!value && typeof value == 'object';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is a native function.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is a native function, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isNative(Array.prototype.push);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isNative(_);
|
||
|
* // => false
|
||
|
*/
|
||
|
function isNative(value) {
|
||
|
if (value == null) {
|
||
|
return false;
|
||
|
}
|
||
|
if (isFunction(value)) {
|
||
|
return reIsNative.test(funcToString.call(value));
|
||
|
}
|
||
|
return isObjectLike(value) &&
|
||
|
(isHostObject(value) ? reIsNative : reIsHostCtor).test(value);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is classified as a `Number` primitive or object.
|
||
|
*
|
||
|
* **Note:** To exclude `Infinity`, `-Infinity`, and `NaN`, which are classified
|
||
|
* as numbers, use the `_.isFinite` method.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isNumber(3);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isNumber(Number.MIN_VALUE);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isNumber(Infinity);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isNumber('3');
|
||
|
* // => false
|
||
|
*/
|
||
|
function isNumber(value) {
|
||
|
return typeof value == 'number' ||
|
||
|
(isObjectLike(value) && objectToString.call(value) == numberTag);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is classified as a `String` primitive or object.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isString('abc');
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isString(1);
|
||
|
* // => false
|
||
|
*/
|
||
|
function isString(value) {
|
||
|
return typeof value == 'string' ||
|
||
|
(!isArray(value) && isObjectLike(value) && objectToString.call(value) == stringTag);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is classified as a `Symbol` primitive or object.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isSymbol(Symbol.iterator);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isSymbol('abc');
|
||
|
* // => false
|
||
|
*/
|
||
|
function isSymbol(value) {
|
||
|
return typeof value == 'symbol' ||
|
||
|
(isObjectLike(value) && objectToString.call(value) == symbolTag);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is classified as a typed array.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isTypedArray(new Uint8Array);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isTypedArray([]);
|
||
|
* // => false
|
||
|
*/
|
||
|
function isTypedArray(value) {
|
||
|
return isObjectLike(value) &&
|
||
|
isLength(value.length) && !!typedArrayTags[objectToString.call(value)];
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `value` is `undefined`.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to check.
|
||
|
* @returns {boolean} Returns `true` if `value` is `undefined`, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* _.isUndefined(void 0);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.isUndefined(null);
|
||
|
* // => false
|
||
|
*/
|
||
|
function isUndefined(value) {
|
||
|
return value === undefined;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Converts `value` to a number.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to process.
|
||
|
* @returns {number} Returns the number.
|
||
|
* @example
|
||
|
*
|
||
|
* _.toNumber(3);
|
||
|
* // => 3
|
||
|
*
|
||
|
* _.toNumber(Number.MIN_VALUE);
|
||
|
* // => 5e-324
|
||
|
*
|
||
|
* _.toNumber(Infinity);
|
||
|
* // => Infinity
|
||
|
*
|
||
|
* _.toNumber('3');
|
||
|
* // => 3
|
||
|
*/
|
||
|
function toNumber(value) {
|
||
|
if (isObject(value)) {
|
||
|
var other = isFunction(value.valueOf) ? value.valueOf() : value;
|
||
|
value = isObject(other) ? (other + '') : other;
|
||
|
}
|
||
|
if (typeof value != 'string') {
|
||
|
return value === 0 ? value : +value;
|
||
|
}
|
||
|
value = value.replace(reTrim, '');
|
||
|
var isBinary = reIsBinary.test(value);
|
||
|
return (isBinary || reIsOctal.test(value))
|
||
|
? freeParseInt(value.slice(2), isBinary ? 2 : 8)
|
||
|
: (reIsBadHex.test(value) ? NAN : +value);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Converts `value` to a string if it's not one. An empty string is returned
|
||
|
* for `null` and `undefined` values. The sign of `-0` is preserved.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Lang
|
||
|
* @param {*} value The value to process.
|
||
|
* @returns {string} Returns the string.
|
||
|
* @example
|
||
|
*
|
||
|
* _.toString(null);
|
||
|
* // => ''
|
||
|
*
|
||
|
* _.toString(-0);
|
||
|
* // => '-0'
|
||
|
*
|
||
|
* _.toString([1, 2, 3]);
|
||
|
* // => '1,2,3'
|
||
|
*/
|
||
|
function toString(value) {
|
||
|
// Exit early for strings to avoid a performance hit in some environments.
|
||
|
if (typeof value == 'string') {
|
||
|
return value;
|
||
|
}
|
||
|
if (value == null) {
|
||
|
return '';
|
||
|
}
|
||
|
if (isSymbol(value)) {
|
||
|
return symbolToString ? symbolToString.call(value) : '';
|
||
|
}
|
||
|
var result = (value + '');
|
||
|
return (result == '0' && (1 / value) == -INFINITY) ? '-0' : result;
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Gets the value at `path` of `object`. If the resolved value is
|
||
|
* `undefined` the `defaultValue` is used in its place.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Object
|
||
|
* @param {Object} object The object to query.
|
||
|
* @param {Array|string} path The path of the property to get.
|
||
|
* @param {*} [defaultValue] The value returned if the resolved value is `undefined`.
|
||
|
* @returns {*} Returns the resolved value.
|
||
|
* @example
|
||
|
*
|
||
|
* var object = { 'a': [{ 'b': { 'c': 3 } }] };
|
||
|
*
|
||
|
* _.get(object, 'a[0].b.c');
|
||
|
* // => 3
|
||
|
*
|
||
|
* _.get(object, ['a', '0', 'b', 'c']);
|
||
|
* // => 3
|
||
|
*
|
||
|
* _.get(object, 'a.b.c', 'default');
|
||
|
* // => 'default'
|
||
|
*/
|
||
|
function get(object, path, defaultValue) {
|
||
|
var result = object == null ? undefined : baseGet(object, path);
|
||
|
return result === undefined ? defaultValue : result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Checks if `path` is a direct or inherited property of `object`.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Object
|
||
|
* @param {Object} object The object to query.
|
||
|
* @param {Array|string} path The path to check.
|
||
|
* @returns {boolean} Returns `true` if `path` exists, else `false`.
|
||
|
* @example
|
||
|
*
|
||
|
* var object = _.create({ 'a': _.create({ 'b': _.create({ 'c': 3 }) }) });
|
||
|
*
|
||
|
* _.hasIn(object, 'a');
|
||
|
* // => true
|
||
|
*
|
||
|
* _.hasIn(object, 'a.b.c');
|
||
|
* // => true
|
||
|
*
|
||
|
* _.hasIn(object, ['a', 'b', 'c']);
|
||
|
* // => true
|
||
|
*
|
||
|
* _.hasIn(object, 'b');
|
||
|
* // => false
|
||
|
*/
|
||
|
function hasIn(object, path) {
|
||
|
return hasPath(object, path, baseHasIn);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates an array of the own enumerable property names of `object`.
|
||
|
*
|
||
|
* **Note:** Non-object values are coerced to objects. See the
|
||
|
* [ES spec](http://ecma-international.org/ecma-262/6.0/#sec-object.keys)
|
||
|
* for more details.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Object
|
||
|
* @param {Object} object The object to query.
|
||
|
* @returns {Array} Returns the array of property names.
|
||
|
* @example
|
||
|
*
|
||
|
* function Foo() {
|
||
|
* this.a = 1;
|
||
|
* this.b = 2;
|
||
|
* }
|
||
|
*
|
||
|
* Foo.prototype.c = 3;
|
||
|
*
|
||
|
* _.keys(new Foo);
|
||
|
* // => ['a', 'b'] (iteration order is not guaranteed)
|
||
|
*
|
||
|
* _.keys('hi');
|
||
|
* // => ['0', '1']
|
||
|
*/
|
||
|
function keys(object) {
|
||
|
var isProto = isPrototype(object);
|
||
|
if (!(isProto || isArrayLike(object))) {
|
||
|
return baseKeys(object);
|
||
|
}
|
||
|
var indexes = indexKeys(object),
|
||
|
skipIndexes = !!indexes,
|
||
|
result = indexes || [],
|
||
|
length = result.length;
|
||
|
|
||
|
for (var key in object) {
|
||
|
if (baseHas(object, key) &&
|
||
|
!(skipIndexes && (key == 'length' || isIndex(key, length))) &&
|
||
|
!(isProto && key == 'constructor')) {
|
||
|
result.push(key);
|
||
|
}
|
||
|
}
|
||
|
return result;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates an array of own enumerable key-value pairs for `object` which
|
||
|
* can be consumed by `_.fromPairs`.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Object
|
||
|
* @param {Object} object The object to query.
|
||
|
* @returns {Array} Returns the new array of key-value pairs.
|
||
|
* @example
|
||
|
*
|
||
|
* function Foo() {
|
||
|
* this.a = 1;
|
||
|
* this.b = 2;
|
||
|
* }
|
||
|
*
|
||
|
* Foo.prototype.c = 3;
|
||
|
*
|
||
|
* _.toPairs(new Foo);
|
||
|
* // => [['a', 1], ['b', 2]] (iteration order is not guaranteed)
|
||
|
*/
|
||
|
function toPairs(object) {
|
||
|
return baseToPairs(object, keys(object));
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Converts the characters "&", "<", ">", '"', "'", and "\`" in `string` to
|
||
|
* their corresponding HTML entities.
|
||
|
*
|
||
|
* **Note:** No other characters are escaped. To escape additional
|
||
|
* characters use a third-party library like [_he_](https://mths.be/he).
|
||
|
*
|
||
|
* Though the ">" character is escaped for symmetry, characters like
|
||
|
* ">" and "/" don't need escaping in HTML and have no special meaning
|
||
|
* unless they're part of a tag or unquoted attribute value.
|
||
|
* See [Mathias Bynens's article](https://mathiasbynens.be/notes/ambiguous-ampersands)
|
||
|
* (under "semi-related fun fact") for more details.
|
||
|
*
|
||
|
* Backticks are escaped because in IE < 9, they can break out of
|
||
|
* attribute values or HTML comments. See [#59](https://html5sec.org/#59),
|
||
|
* [#102](https://html5sec.org/#102), [#108](https://html5sec.org/#108), and
|
||
|
* [#133](https://html5sec.org/#133) of the [HTML5 Security Cheatsheet](https://html5sec.org/)
|
||
|
* for more details.
|
||
|
*
|
||
|
* When working with HTML you should always [quote attribute values](http://wonko.com/post/html-escaping)
|
||
|
* to reduce XSS vectors.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category String
|
||
|
* @param {string} [string=''] The string to escape.
|
||
|
* @returns {string} Returns the escaped string.
|
||
|
* @example
|
||
|
*
|
||
|
* _.escape('fred, barney, & pebbles');
|
||
|
* // => 'fred, barney, & pebbles'
|
||
|
*/
|
||
|
function escape(string) {
|
||
|
string = toString(string);
|
||
|
return (string && reHasUnescapedHtml.test(string))
|
||
|
? string.replace(reUnescapedHtml, escapeHtmlChar)
|
||
|
: string;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Escapes the `RegExp` special characters "^", "$", "\", ".", "*", "+",
|
||
|
* "?", "(", ")", "[", "]", "{", "}", and "|" in `string`.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category String
|
||
|
* @param {string} [string=''] The string to escape.
|
||
|
* @returns {string} Returns the escaped string.
|
||
|
* @example
|
||
|
*
|
||
|
* _.escapeRegExp('[lodash](https://lodash.com/)');
|
||
|
* // => '\[lodash\]\(https://lodash\.com/\)'
|
||
|
*/
|
||
|
function escapeRegExp(string) {
|
||
|
string = toString(string);
|
||
|
return (string && reHasRegExpChar.test(string))
|
||
|
? string.replace(reRegExpChar, '\\$&')
|
||
|
: string;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Replaces matches for `pattern` in `string` with `replacement`.
|
||
|
*
|
||
|
* **Note:** This method is based on [`String#replace`](https://mdn.io/String/replace).
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category String
|
||
|
* @param {string} [string=''] The string to modify.
|
||
|
* @param {RegExp|string} pattern The pattern to replace.
|
||
|
* @param {Function|string} replacement The match replacement.
|
||
|
* @returns {string} Returns the modified string.
|
||
|
* @example
|
||
|
*
|
||
|
* _.replace('Hi Fred', 'Fred', 'Barney');
|
||
|
* // => 'Hi Barney'
|
||
|
*/
|
||
|
function replace() {
|
||
|
var args = arguments,
|
||
|
string = toString(args[0]);
|
||
|
|
||
|
return args.length < 3 ? string : string.replace(args[1], args[2]);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* The inverse of `_.escape`; this method converts the HTML entities
|
||
|
* `&`, `<`, `>`, `"`, `'`, and ``` in `string` to their
|
||
|
* corresponding characters.
|
||
|
*
|
||
|
* **Note:** No other HTML entities are unescaped. To unescape additional HTML
|
||
|
* entities use a third-party library like [_he_](https://mths.be/he).
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category String
|
||
|
* @param {string} [string=''] The string to unescape.
|
||
|
* @returns {string} Returns the unescaped string.
|
||
|
* @example
|
||
|
*
|
||
|
* _.unescape('fred, barney, & pebbles');
|
||
|
* // => 'fred, barney, & pebbles'
|
||
|
*/
|
||
|
function unescape(string) {
|
||
|
string = toString(string);
|
||
|
return (string && reHasEscapedHtml.test(string))
|
||
|
? string.replace(reEscapedHtml, unescapeHtmlChar)
|
||
|
: string;
|
||
|
}
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* Creates a function that returns `value`.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Util
|
||
|
* @param {*} value The value to return from the new function.
|
||
|
* @returns {Function} Returns the new function.
|
||
|
* @example
|
||
|
*
|
||
|
* var object = { 'user': 'fred' };
|
||
|
* var getter = _.constant(object);
|
||
|
*
|
||
|
* getter() === object;
|
||
|
* // => true
|
||
|
*/
|
||
|
function constant(value) {
|
||
|
return function() {
|
||
|
return value;
|
||
|
};
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* This method returns the first argument given to it.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Util
|
||
|
* @param {*} value Any value.
|
||
|
* @returns {*} Returns `value`.
|
||
|
* @example
|
||
|
*
|
||
|
* var object = { 'user': 'fred' };
|
||
|
*
|
||
|
* _.identity(object) === object;
|
||
|
* // => true
|
||
|
*/
|
||
|
function identity(value) {
|
||
|
return value;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a function that invokes `func` with the arguments of the created
|
||
|
* function. If `func` is a property name the created callback returns the
|
||
|
* property value for a given element. If `func` is an object the created
|
||
|
* callback returns `true` for elements that contain the equivalent object
|
||
|
* properties, otherwise it returns `false`.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Util
|
||
|
* @param {*} [func=_.identity] The value to convert to a callback.
|
||
|
* @returns {Function} Returns the callback.
|
||
|
* @example
|
||
|
*
|
||
|
* var users = [
|
||
|
* { 'user': 'barney', 'age': 36 },
|
||
|
* { 'user': 'fred', 'age': 40 }
|
||
|
* ];
|
||
|
*
|
||
|
* // Create custom iteratee shorthands.
|
||
|
* _.iteratee = _.wrap(_.iteratee, function(callback, func) {
|
||
|
* var p = /^(\S+)\s*([<>])\s*(\S+)$/.exec(func);
|
||
|
* return !p ? callback(func) : function(object) {
|
||
|
* return (p[2] == '>' ? object[p[1]] > p[3] : object[p[1]] < p[3]);
|
||
|
* };
|
||
|
* });
|
||
|
*
|
||
|
* _.filter(users, 'age > 36');
|
||
|
* // => [{ 'user': 'fred', 'age': 40 }]
|
||
|
*/
|
||
|
function iteratee(func) {
|
||
|
return baseIteratee(typeof func == 'function' ? func : baseClone(func, true));
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates a function that returns the value at `path` of a given object.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Util
|
||
|
* @param {Array|string} path The path of the property to get.
|
||
|
* @returns {Function} Returns the new function.
|
||
|
* @example
|
||
|
*
|
||
|
* var objects = [
|
||
|
* { 'a': { 'b': { 'c': 2 } } },
|
||
|
* { 'a': { 'b': { 'c': 1 } } }
|
||
|
* ];
|
||
|
*
|
||
|
* _.map(objects, _.property('a.b.c'));
|
||
|
* // => [2, 1]
|
||
|
*
|
||
|
* _.map(_.sortBy(objects, _.property(['a', 'b', 'c'])), 'a.b.c');
|
||
|
* // => [1, 2]
|
||
|
*/
|
||
|
function property(path) {
|
||
|
return isKey(path) ? baseProperty(path) : basePropertyDeep(path);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Creates an array of numbers (positive and/or negative) progressing from
|
||
|
* `start` up to, but not including, `end`. A step of `-1` is used if a negative
|
||
|
* `start` is specified without an `end` or `step`. If `end` is not specified
|
||
|
* it's set to `start` with `start` then set to `0`.
|
||
|
*
|
||
|
* **Note:** JavaScript follows the IEEE-754 standard for resolving
|
||
|
* floating-point values which can produce unexpected results.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Util
|
||
|
* @param {number} [start=0] The start of the range.
|
||
|
* @param {number} end The end of the range.
|
||
|
* @param {number} [step=1] The value to increment or decrement by.
|
||
|
* @returns {Array} Returns the new array of numbers.
|
||
|
* @example
|
||
|
*
|
||
|
* _.range(4);
|
||
|
* // => [0, 1, 2, 3]
|
||
|
*
|
||
|
* _.range(-4);
|
||
|
* // => [0, -1, -2, -3]
|
||
|
*
|
||
|
* _.range(1, 5);
|
||
|
* // => [1, 2, 3, 4]
|
||
|
*
|
||
|
* _.range(0, 20, 5);
|
||
|
* // => [0, 5, 10, 15]
|
||
|
*
|
||
|
* _.range(0, -4, -1);
|
||
|
* // => [0, -1, -2, -3]
|
||
|
*
|
||
|
* _.range(1, 4, 0);
|
||
|
* // => [1, 1, 1]
|
||
|
*
|
||
|
* _.range(0);
|
||
|
* // => []
|
||
|
*/
|
||
|
var range = createRange();
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
// Avoid inheriting from `Object.prototype` when possible.
|
||
|
Hash.prototype = nativeCreate ? nativeCreate(null) : objectProto;
|
||
|
|
||
|
// Add functions to the `MapCache`.
|
||
|
MapCache.prototype.clear = mapClear;
|
||
|
MapCache.prototype['delete'] = mapDelete;
|
||
|
MapCache.prototype.get = mapGet;
|
||
|
MapCache.prototype.has = mapHas;
|
||
|
MapCache.prototype.set = mapSet;
|
||
|
|
||
|
// Add functions to the `Stack` cache.
|
||
|
Stack.prototype.clear = stackClear;
|
||
|
Stack.prototype['delete'] = stackDelete;
|
||
|
Stack.prototype.get = stackGet;
|
||
|
Stack.prototype.has = stackHas;
|
||
|
Stack.prototype.set = stackSet;
|
||
|
|
||
|
// Add functions that return wrapped values when chaining.
|
||
|
lodash.constant = constant;
|
||
|
lodash.iteratee = iteratee;
|
||
|
lodash.keys = keys;
|
||
|
lodash.map = map;
|
||
|
lodash.property = property;
|
||
|
lodash.range = range;
|
||
|
lodash.toPairs = toPairs;
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
// Add functions that return unwrapped values when chaining.
|
||
|
lodash.eq = eq;
|
||
|
lodash.escape = escape;
|
||
|
lodash.escapeRegExp = escapeRegExp;
|
||
|
lodash.forEach = forEach;
|
||
|
lodash.get = get;
|
||
|
lodash.hasIn = hasIn;
|
||
|
lodash.identity = identity;
|
||
|
lodash.isArguments = isArguments;
|
||
|
lodash.isArray = isArray;
|
||
|
lodash.isArrayLike = isArrayLike;
|
||
|
lodash.isArrayLikeObject = isArrayLikeObject;
|
||
|
lodash.isBuffer = isBuffer;
|
||
|
lodash.isFunction = isFunction;
|
||
|
lodash.isLength = isLength;
|
||
|
lodash.isNative = isNative;
|
||
|
lodash.isNumber = isNumber;
|
||
|
lodash.isObject = isObject;
|
||
|
lodash.isObjectLike = isObjectLike;
|
||
|
lodash.isString = isString;
|
||
|
lodash.isSymbol = isSymbol;
|
||
|
lodash.isTypedArray = isTypedArray;
|
||
|
lodash.isUndefined = isUndefined;
|
||
|
lodash.last = last;
|
||
|
lodash.replace = replace;
|
||
|
lodash.toNumber = toNumber;
|
||
|
lodash.toString = toString;
|
||
|
lodash.unescape = unescape;
|
||
|
|
||
|
// Add aliases.
|
||
|
lodash.each = forEach;
|
||
|
|
||
|
/*------------------------------------------------------------------------*/
|
||
|
|
||
|
/**
|
||
|
* The semantic version number.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @type {string}
|
||
|
*/
|
||
|
lodash.VERSION = VERSION;
|
||
|
|
||
|
/*--------------------------------------------------------------------------*/
|
||
|
|
||
|
// Expose lodash on the free variable `window` or `self` when available. This
|
||
|
// prevents errors in cases where lodash is loaded by a script tag in the presence
|
||
|
// of an AMD loader. See http://requirejs.org/docs/errors.html#mismatch for more details.
|
||
|
(freeWindow || freeSelf || {})._ = lodash;
|
||
|
|
||
|
// Export to the global object.
|
||
|
root._ = lodash;
|
||
|
}.call(this));
|