34 lines
1.0 KiB
JavaScript
34 lines
1.0 KiB
JavaScript
|
var baseDifference = require('./_baseDifference'),
|
||
|
|
baseFlatten = require('./_baseFlatten'),
|
||
|
|
baseRest = require('./_baseRest'),
|
||
|
|
isArrayLikeObject = require('./isArrayLikeObject');
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Creates an array of `array` values not included in the other given arrays
|
||
|
|
* using [`SameValueZero`](http://ecma-international.org/ecma-262/7.0/#sec-samevaluezero)
|
||
|
|
* for equality comparisons. The order and references of result values are
|
||
|
|
* determined by the first array.
|
||
|
|
*
|
||
|
|
* **Note:** Unlike `_.pullAll`, this method returns a new array.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @since 0.1.0
|
||
|
|
* @category Array
|
||
|
|
* @param {Array} array The array to inspect.
|
||
|
|
* @param {...Array} [values] The values to exclude.
|
||
|
|
* @returns {Array} Returns the new array of filtered values.
|
||
|
|
* @see _.without, _.xor
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* _.difference([2, 1], [2, 3]);
|
||
|
|
* // => [1]
|
||
|
|
*/
|
||
|
|
var difference = baseRest(function(array, values) {
|
||
|
|
return isArrayLikeObject(array)
|
||
|
|
? baseDifference(array, baseFlatten(values, 1, isArrayLikeObject, true))
|
||
|
|
: [];
|
||
|
|
});
|
||
|
|
|
||
|
|
module.exports = difference;
|