dart:html

метод sort

Сортирует этот список в соответствии с порядком, заданным функцией compare.

Функция compare должна работать как компаратор.

final numbers = <String>['two', 'three', 'four'];
// Sort from shortest to longest.
numbers.sort((a, b) => a.length.compareTo(b.length));
print(numbers); // [two, four, three]

В реализациях List по умолчанию используется Comparable.compare, если compare не указана.

final numbers = <int>[13, 2, -11, 0];
numbers.sort();
print(numbers); // [-11, 0, 2, 13]

В этом случае элементы списка должны быть сравнимы друг с другом.

Компаратор может считать объекты равными (возвращать ноль), даже если это разные объекты. Функция сортировки не гарантирует стабильность, поэтому разные объекты, которые считаются равными, могут располагаться в результате в любом порядке:

final numbers = <String>['one', 'two', 'three', 'four'];
numbers.sort((a, b) => a.length.compareTo(b.length));
print(numbers); // [one, two, four, three] OR [two, one, four, three]

Реализация

void sort([int compare(E a, E b)?]) {
  throw new UnsupportedError("Cannot sort immutable List.");
}