List.sortByColumn
sortByColumn($columnKey, $options = {}) -> self
Description
Sort a multi-dimensional List (a List-of-Maps or a List-of-Lists) by values of a given column key.
// List of Maps (e.g. from `Db.selectRows`)
$users = [
{ id: 0, name: 'Bob' },
{ id: 1, name: 'Cat' },
{ id: 2, name: 'Ann' },
]
$users.sortByColumn('name')
// [
// { id: 2, name: 'Ann' },
// { id: 0, name: 'Bob' },
// { id: 1, name: 'Cat' },
// ]
Example of sorting a List-of-Lists.
$points = [
[0, 300],
[1, 100],
[2, 200],
]
// Sort by index 1
$points.sortByColumn(1)
// [
// [1, 100],
// [2, 200],
// [0, 300],
// ]
Options
| Option | Value | Description |
|---|---|---|
reverse |
true/false | Items will be sorted in descending order. |
$users.sortByColumn('name', -reverse)
// [
// { id: 1, name: 'Cat' },
// { id: 0, name: 'Bob' },
// { id: 2, name: 'Ann' },
// ]