@extra-array/sort-update

Arranges values in an order.
:package:
:smiley_cat:
:running:
:vhs:
:moon:
:scroll:
:newspaper:
:blue_book:

> Alternatives: [sort], [sort$].

> Similar: [sort], [merge].

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

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

``javascript
array.sort$(x, [fc], [fm]);
// x: an array (updated)
// fc: compare function (a, b)
// fm: map function (v, i, x)
// → x
`

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

var x = [-2, -3, 1, 4];
array.sort$(x);
// [ -3, -2, 1, 4 ] (compares numbers)

x;
// [ -3, -2, 1, 4 ]

var x = [-2, -3, 1, 4];
array.sort$(x, (a, b) => Math.abs(a) - Math.abs(b));
// [ 1, -2, -3, 4 ]

var x = [-2, -3, 1, 4];
array.sort$(x, null, v => Math.abs(v));
// [ 1, -2, -3, 4 ]
``

References

- Data.Sort.sortBy: Haskell
- Array.prototype.sort: MDN web docs
- Array.sortBy: sugarjs

[sort]: https://github.com/nodef/extra-array/wiki/sort
[sort$]: https://github.com/nodef/extra-array/wiki/sort$
[merge]: https://github.com/nodef/extra-array/wiki/merge