@extra-array/bsearch

Binary searches leftmost value in [sorted] array. [:running:] [:vhs:] [:package:] [:moon:] [:ledger:]
> Alternatives: [bsearch], [bsearchRight], [bsearchAny], [bsearchClosest].

> This is part of package [extra-array].

[extra-array]: https://www.npmjs.com/package/extra-array

``javascript
array.bsearch(x, v, [fc], [fm]);
// x: an array (sorted)
// v: search value
// fc: compare function (a, b)
// fm: map function (v, i, x)
// --> first index of value | ~(index of closest value)
`

`javascript
const array = require('extra-array');

var x = [1, 3, 3, 3, 5];
array.bsearch(x, 3);
// 1 ^ found leftmost

array.bsearch(x, 4);
// -5 (~4) ^ not found, closest

var x = [1, -3, -3, -3, 5];
array.bsearch(x, 3, (a, b) => Math.abs(a) - Math.abs(b));
// 1 ^

array.bsearch(x, 3, null, v => Math.abs(v));
// 1 ^
``

$3

- _.sortedIndex: lodash
- _.sortedIndexBy: lodash
- _.sortedIndexOf: lodash
- array-binsearch: @krisselden
- binarysearch: @soldair
- binary-search: @darkskyapp

[sorted]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort
[:running:]: https://npm.runkit.com/@extra-array/bsearch
[:package:]: https://www.npmjs.com/package/@extra-array/bsearch
[:moon:]: https://www.npmjs.com/package/@extra-array/bsearch.min
[:ledger:]: https://unpkg.com/@extra-array/bsearch/
[bsearch]: https://github.com/nodef/extra-array/wiki/bsearch
[bsearchRight]: https://github.com/nodef/extra-array/wiki/bsearchRight
[bsearchAny]: https://github.com/nodef/extra-array/wiki/bsearchAny
[bsearchClosest]: https://github.com/nodef/extra-array/wiki/bsearchClosest
[:vhs:]: https://asciinema.org/a/332020