@extra-array/sort-on-update

Arranges values in an order. [:running:] [:vhs:] [:package:] [:moon:]
> Alternatives: [compare], [compare-update], [map], [map-update].

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

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

``javascript
array.sortOn$(x, [fn], [ths]);
// x: an array (updated)
// fn: map function (v, i, x)
// ths: this argument
// --> x
`

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

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

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

var x = ['B', 'D', 'a', 'c'];
array.sortOn$(x, v => v.toLowerCase());
// [ 'a', 'B', 'c', 'D' ]
``

$3

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

[compare]: https://github.com/nodef/extra-array/wiki/sort
[compare-update]: https://github.com/nodef/extra-array/wiki/sort$
[map]: https://github.com/nodef/extra-array/wiki/sortOn
[map-update]: https://github.com/nodef/extra-array/wiki/sortOn$
[:running:]: https://npm.runkit.com/@extra-array/sort-on-update
[:package:]: https://www.npmjs.com/package/@extra-array/sort-on-update
[:moon:]: https://www.npmjs.com/package/@extra-array/sort-on-update.min
[:vhs:]: https://asciinema.org/a/319429