rangedSort$ - nodef/extra-array GitHub Wiki

Arrange a range of values in order!

Alternatives: rangedSort, rangedSort$. Similar: sort, rangedSort, partialSort, rangedPartialSort.

function rangedSort$(x, i, I, fc, fm, fs)
// x:  an array (updated!)
// i:  begin index
// I:  end index (exclusive)
// fc: compare function (a, b)
// fm: map function (v, i, x)
// fs: swap function (x, i, j)
const xarray = require('extra-array');


// Sort a range of values (index 0 to 2).
var x = [4, -3, 1, -2];
xarray.rangedSort$(x, 0, 2);
// → [ -3, 4, 1, -2 ]  (compares numbers, x is updated!)
x;
// → [ -3, 4, 1, -2 ]

// Sort a range of values (index 0 to 3).
var x = [4, -3, 1, -2];
xarray.rangedSort$(x, 0, 2);
// → [ -3, 1, 4, -2 ]


// Sort using absolute values.
var x = [4, -3, 1, -2];
xarray.rangedSort$(x, 0, 3, null, v => Math.abs(v));
// → [ 1, -3, 4, -2 ]

References