sort

Arrange values in order.

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

function sort(x, fc, fm, fs)
// x:  an array
// fc: compare function (a, b)
// fm: map function (v, i, x)
// fs: swap function (x, i, j)

const xarray = require('extra-array');


// Sort using default comparison.
var x = [-2, -3, 1, 4];
xarray.sort(x);
// → [ -3, -2, 1, 4 ]  (compares numbers)


// Sort using absolute comparison.
xarray.sort(x, (a, b) => Math.abs(a) - Math.abs(b));
// → [ 1, -2, -3, 4 ]


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

References

• Data.Sort.sortBy() : Haskell
• Array.prototype.sort() : MDN Web Docs
• std::list::sort() : cppreference.com
• Array.sortBy() : Sugar.js
• immutable-array-prototype : @azu