Spec-Zone.ru › Dart 2

dart:js

Метод sort

void sort(
  1. [int compare(
    1. E a,
    2. E b
    )?]
)
override

Сортирует этот список в порядке, заданном функцией 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]

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

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

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]

Реализация

external void sort([int compare(E a, E b)?]);

© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.18.5/dart-js/JsArray/sort.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API