Binary searches leftmost value in sorted array.
npm install @extra-array/bsearch.minBinary 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
> This is browserified, minified version of [@extra-array/bsearch].
> It is exported as global variable array_bsearch.
> CDN: [unpkg], [jsDelivr].
[@extra-array/bsearch]: https://www.npmjs.com/package/@extra-array/bsearch
[unpkg]: https://unpkg.com/@extra-array/bsearch.min
[jsDelivr]: https://cdn.jsdelivr.net/npm/@extra-array/bsearch.min
``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 ^
``
- _.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