@extra-array/bsearchc

Binary searches closest value in [sorted] array.
> Alternatives: [default], [closest], [left], [right].

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

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

``javascript
array.bsearchc(x, v, [fn]);
// x: an array (sorted)
// v: value to find
// fn: compare function (a, b)
// --> index of closest value
`

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

array.bsearchc([1, 3, 5, 7], 5);
// 2 ^ found

array.bsearchc([1, 3, 5, 7], 4);
// 2 ^ closest

array.bsearchc([4, 4, 4, 4], 4);
// 2 ^ not left/right most

array.bsearchc(['b', 'GB', 'KB', 'MB'], 'kB', (a, b) => {
return a.toLowerCase().localeCompare(b.toLowerCase());
});
// 2 ^ case insensitive
``

$3

- array-binsearch: @krisselden
- binarysearch: @soldair

[sorted]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort
[default]: https://github.com/nodef/extra-array/wiki/bsearch
[closest]: https://github.com/nodef/extra-array/wiki/bsearchc
[left]: https://github.com/nodef/extra-array/wiki/bsearchl
[right]: https://github.com/nodef/extra-array/wiki/bsearchr