ListBase<E> класс

Абстрактная реализация списка.

ListBase можно использовать в качестве базового класса для реализации интерфейса List.

Этот класс реализует все операции чтения, используя только элементы length и operator[]. Он реализует операции записи, используя их, а также add, length= и operator[]=. Классы, использующие этот базовый класс, должны реализовать эти пять операций.

ВНИМАНИЕ: Для обеспечения обратной совместимости предусмотрена реализация add по умолчанию, которая работает только со списками, тип элементов которых допускает значение null. Для списка с типом элементов, не допускающим значение null, необходимо реализовать метод add.

ВНИМАНИЕ: Простое перенаправление только четырёх операций чтения/записи length и [] в обычный расширяемый List (созданный с помощью литерала []) приведёт к очень низкой производительности операций add и addAll для ListBase. Эти операции реализованы так, что длина списка увеличивается на единицу при каждой операции add, а многократное увеличение длины расширяемого списка неэффективно. Чтобы избежать этого, переопределите 'add' и 'addAll', чтобы также напрямую перенаправлять вызовы расширяемому списку, или, если возможно, используйте DelegatingList из "package:collection/collection.dart" вместо ListMixin.

Подмешанные типы

ListMixin<E>

Реализующие классы

Доступные расширения

EnumByName

Конструкторы

ListBase()

Свойства

first ↔ E чтение / записьунаследовано: Возвращает первый элемент.
hashCode → int только чтениеунаследовано: Хеш-код этого объекта.
isEmpty → bool только чтениеунаследовано: Проверяет, что в этой коллекции нет элементов.
isNotEmpty → bool только чтениеунаследовано: Проверяет, что в этой коллекции есть хотя бы один элемент.
iterator → Iterator<E> только чтениеунаследовано: Возвращает новый Iterator, позволяющий перебирать элементы этой Iterable.
last ↔ E чтение / записьунаследовано: Возвращает последний элемент.
length ↔ int чтение / записьунаследовано: Количество объектов в этом списке.
reversed → Iterable<E> только чтениеунаследовано: Iterable объектов этого списка в обратном порядке.
runtimeType → Type только чтениеунаследовано: Представление типа объекта во время выполнения.
single → E только чтениеунаследовано: Проверяет, что этот итерируемый объект содержит только один элемент, и возвращает его.

Методы

add(E element) → void унаследовано: Добавляет value в конец этого списка, увеличивая его длину на единицу.
addAll(Iterable<E> iterable) → void унаследовано: Добавляет все объекты из iterable в конец этого списка.
any(bool test(E element)) → bool унаследовано: Проверяет, удовлетворяет ли хотя бы один элемент этого итерируемого объекта условию test.
asMap() → Map<int, E> унаследовано: Неизменяемое представление этого списка в виде Map.
cast<R>() → List<R> унаследовано: Возвращает представление этого списка как списка экземпляров R.
clear() → void унаследовано: Удаляет все объекты из этого списка; длина списка становится равной нулю.
contains(Object? element) → bool унаследовано: Проверяет, содержит ли коллекция элемент, равный element.
elementAt(int index) → E унаследовано: Возвращает элемент с индексом index.
every(bool test(E element)) → bool унаследовано: Проверяет, удовлетворяет ли каждый элемент этого итерируемого объекта условию test.
expand<T>(Iterable<T> f(E element)) → Iterable<T> унаследовано: Преобразует каждый элемент этого Iterable в ноль или более элементов.
fillRange(int start, int end, [E? fill]) → void унаследовано: Заменяет элементы в диапазоне значением fillValue.
firstWhere(bool test(E element), {E orElse()?}) → E унаследовано: Возвращает первый элемент, удовлетворяющий заданному предикату test.
fold<T>(T initialValue, T combine(T previousValue, E element)) → T унаследовано: Сводит коллекцию к одному значению, последовательно объединяя каждый её элемент с текущим значением.
followedBy(Iterable<E> other) → Iterable<E> унаследовано: Возвращает ленивую конкатенацию этого итерируемого объекта и other.
forEach(void action(E element)) → void унаследовано: Вызывает action для каждого элемента этого итерируемого объекта в порядке обхода.
getRange(int start, int end) → Iterable<E> унаследовано: Создаёт Iterable, перебирающий элементы заданного диапазона.
indexOf(Object? element, [int start = 0]) → int унаследовано: Первый индекс элемента element в этом списке.
indexWhere(bool test(E element), [int start = 0]) → int унаследовано: Первый индекс в списке, удовлетворяющий заданному условию test.
insert(int index, E element) → void унаследовано: Вставляет element в позицию index этого списка.
insertAll(int index, Iterable<E> iterable) → void унаследовано: Вставляет все объекты из iterable в позицию index этого списка.
join([String separator = ""]) → String унаследовано: Преобразует каждый элемент в String и объединяет полученные строки.
lastIndexOf(Object? element, [int? start]) → int унаследовано: Последний индекс элемента element в этом списке.
lastIndexWhere(bool test(E element), [int? start]) → int унаследовано: Последний индекс в списке, удовлетворяющий заданному условию test.
lastWhere(bool test(E element), {E orElse()?}) → E унаследовано: Возвращает последний элемент, удовлетворяющий заданному предикату test.
map<T>(T f(E element)) → Iterable<T> унаследовано: Текущие элементы этого итерируемого объекта, преобразованные функцией toElement.
noSuchMethod(Invocation invocation) → dynamic унаследовано: Вызывается при обращении к несуществующему методу или свойству.
reduce(E combine(E previousValue, E element)) → E унаследовано: Сводит коллекцию к одному значению, последовательно объединяя её элементы с помощью заданной функции.
remove(Object? element) → bool унаследовано: Удаляет из этого списка первое вхождение value.
removeAt(int index) → E унаследовано: Удаляет объект из позиции index этого списка.
removeLast() → E унаследовано: Удаляет и возвращает последний объект этого списка.
removeRange(int start, int end) → void унаследовано: Удаляет диапазон элементов из списка.
removeWhere(bool test(E element)) → void унаследовано: Удаляет из этого списка все объекты, удовлетворяющие условию test.
replaceRange(int start, int end, Iterable<E> newContents) → void унаследовано: Заменяет диапазон элементов элементами из replacements.
retainWhere(bool test(E element)) → void унаследовано: Удаляет из этого списка все объекты, не удовлетворяющие условию test.
setAll(int index, Iterable<E> iterable) → void унаследовано: Заменяет элементы объектами из iterable.
setRange(int start, int end, Iterable<E> iterable, [int skipCount = 0]) → void унаследовано: Записывает некоторые элементы из iterable в диапазон этого списка.
shuffle([Random? random]) → void унаследовано: Перемешивает элементы этого списка в случайном порядке.
singleWhere(bool test(E element), {E orElse()?}) → E унаследовано: Возвращает единственный элемент, удовлетворяющий условию test.
skip(int count) → Iterable<E> унаследовано: Возвращает Iterable, содержащий все элементы, кроме первых count.
skipWhile(bool test(E element)) → Iterable<E> унаследовано: Возвращает Iterable, пропускающий начальные элементы, пока выполняется условие test.
sort([int compare(E a, E b)?]) → void унаследовано: Сортирует этот список в порядке, заданном функцией compare.
sublist(int start, [int? end]) → List<E> унаследовано: Возвращает новый список, содержащий элементы между start и end.
take(int count) → Iterable<E> унаследовано: Возвращает ленивый итерируемый объект с первыми count элементами этого итерируемого объекта.
takeWhile(bool test(E element)) → Iterable<E> унаследовано: Возвращает ленивый итерируемый объект с начальными элементами, удовлетворяющими условию test.
toList({bool growable = true}) → List<E> унаследовано: Создаёт List, содержащий элементы этого Iterable.
toSet() → Set<E> унаследовано: Создаёт Set, содержащий те же элементы, что и этот итерируемый объект.
toString() → String унаследовано: Строковое представление этого объекта.
where(bool test(E element)) → Iterable<E> унаследовано: Возвращает новый ленивый Iterable со всеми элементами, удовлетворяющими предикату test.
whereType<T>() → Iterable<T> унаследовано: Возвращает новый ленивый Iterable со всеми элементами типа T.

Операторы

operator +(List<E> other) → List<E> унаследовано: Возвращает результат конкатенации этого списка и other.
operator ==(Object other) → bool унаследовано: Оператор равенства.
operator [](int index) → E унаследовано: Объект по указанному index в списке.
operator []=(int index, E value) → void унаследовано: Устанавливает значение value по указанному index в списке.

Статические методы

listToString(List list) → String: Преобразует List в String.

© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.19.6/dart-collection/ListBase-class.html