pull.js 758 B

123456789101112131415161718192021222324252627282930
  1. var baseRest = require('./_baseRest'),
  2. pullAll = require('./pullAll');
  3. /**
  4. * Removes all given values from `array` using
  5. * [`SameValueZero`](http://ecma-international.org/ecma-262/7.0/#sec-samevaluezero)
  6. * for equality comparisons.
  7. *
  8. * **Note:** Unlike `_.without`, this method mutates `array`. Use `_.remove`
  9. * to remove elements from an array by predicate.
  10. *
  11. * @static
  12. * @memberOf _
  13. * @since 2.0.0
  14. * @category Array
  15. * @param {Array} array The array to modify.
  16. * @param {...*} [values] The values to remove.
  17. * @returns {Array} Returns `array`.
  18. * @example
  19. *
  20. * var array = ['a', 'b', 'c', 'a', 'b', 'c'];
  21. *
  22. * _.pull(array, 'a', 'c');
  23. * console.log(array);
  24. * // => ['b', 'b']
  25. */
  26. var pull = baseRest(pullAll);
  27. module.exports = pull;