arr-diff

What is arr-diff?

The arr-diff npm package is used to compute the difference between one or more arrays, returning an array that contains the values from the first array that are not present in the other arrays.

What are arr-diff's main functionalities?

Basic array difference

This feature allows you to find the elements that are present in the first array but not in the subsequent arrays. The code sample demonstrates how to use arr-diff to filter out the numbers 2 and 4 from the array [1, 2, 3, 4, 5], resulting in [1, 3, 5].

[1, 2, 3, 4, 5].filter(arrDiff([2, 4]))

Multiple array difference

This feature is used to find the difference between one array and multiple other arrays. The code sample shows how to use arr-diff to filter out the numbers 2, 3, 4, and 5 from the array [1, 2, 3, 4, 5], resulting in [1].

[1, 2, 3, 4, 5].filter(arrDiff([2, 3], [4, 5]))

Other packages similar to arr-diff

lodash.difference

Lodash's difference function is similar to arr-diff. It creates an array of array values not included in the other given arrays using SameValueZero for equality comparisons. Lodash is a more extensive utility library that includes a wide range of functions for different purposes.

underscore

Underscore.js is a utility library that offers the _.difference function, which is similar to arr-diff's functionality. It returns the values from the first array that are not present in the other arrays. Underscore.js provides a more comprehensive set of utility functions beyond array manipulation.

ramda

Ramda is a functional programming library that includes a difference function, which behaves similarly to arr-diff. It focuses on a more functional programming approach and offers a suite of tools for this paradigm.

README

arr-diff

Returns an array with only the unique values from the first array, by excluding all values from additional arrays using strict equality for comparisons.

Install

Install with npm:

$ npm install arr-diff --save

Install with bower

$ bower install arr-diff --save

Usage

Returns the difference between the first array and additional arrays.

var diff = require('arr-diff');

var a = ['a', 'b', 'c', 'd'];
var b = ['b', 'c'];

console.log(diff(a, b))
//=> ['a', 'd']

Benchmarks

This library versus array-differ, on May 07, 2016:

# benchmark/fixtures/long.js (94529 bytes)
  current x 1,246 ops/sec ±0.98% (85 runs sampled)
  array-differ x 993 ops/sec ±1.35% (87 runs sampled)

# benchmark/fixtures/med.js (708 bytes)
  current x 583,612 ops/sec ±1.24% (87 runs sampled)
  array-differ x 464,480 ops/sec ±1.42% (85 runs sampled)

# benchmark/fixtures/short.js (60 bytes)
  current x 788,823 ops/sec ±0.95% (89 runs sampled)
  array-differ x 521,483 ops/sec ±1.65% (86 runs sampled)

Related projects

You might also be interested in these projects:

• arr-flatten: Recursively flatten an array or arrays. This is the fastest implementation of array flatten. | homepage
• array-filter: Array#filter for older browsers. | homepage
• array-intersection: Return an array with the unique values present in all given arrays using strict equality… more | homepage

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

Generate readme and API documentation with verb:

$ npm install verb && npm run docs

Or, if verb is installed globally:

$ verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.

---

This file was generated by verb, v0.9.0, on May 07, 2016.