ListBase<E> класс

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

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

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

ПРИМЕЧАНИЕ: По соображениям обратной совместимости существует реализация по умолчанию add, которая работает только для списков с типом элементов, допускающим значение null. Для списков с не-nullable типом элементов метод 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 inherited: Добавляет value в конец этого списка, увеличивая его длину на единицу.
addAll(Iterable<E> iterable) → void inherited: Добавляет все элементы iterable в конец этого списка.
any(bool test(E element)) → bool inherited: Проверяет, удовлетворяет ли какой-либо элемент этого итерируемого объекта условию test.
asMap() → Map<int, E> inherited: Неизменяемое представление этого списка в виде Map.
cast<R>() → List<R> inherited: Возвращает представление этого списка как список экземпляров R.
clear() → void inherited: Удаляет все элементы из этого списка; длина списка становится равной нулю.
contains(Object? element) → bool inherited: Является ли коллекция содержит элемент, равный element.
elementAt(int index) → E inherited: Возвращает index-й элемент.
every(bool test(E element)) → bool inherited: Проверяет, удовлетворяет ли каждый элемент этого итерируемого объекта условию test.
expand<T>(Iterable<T> f(E element)) → Iterable<T> inherited: Расширяет каждый элемент этого итерируемого объекта на ноль или более элементов.
fillRange(int start, int end, [E? fill]) → void inherited: Заменяет диапазон элементов на fillValue.
firstWhere(bool test(E element), {E orElse()?}) → E inherited: Возвращает первый элемент, удовлетворяющий заданному предикату test.
fold<T>(T initialValue, T combine(T previousValue, E element)) → T inherited: Сводит коллекцию к одному значению, итеративно комбинируя каждый элемент коллекции с существующим значением.
followedBy(Iterable<E> other) → Iterable<E> inherited: Возвращает ленивую конкатенацию этого итерируемого объекта и other.
forEach(void action(E element)) → void inherited: Вызывает action для каждого элемента этого итерируемого объекта в порядке итерации.
getRange(int start, int end) → Iterable<E> inherited: Создаёт Iterable, которая перебирает диапазон элементов.
indexOf(Object? element, [int start = 0]) → int inherited: Первый индекс element в этом списке.
indexWhere(bool test(E element), [int start = 0]) → int inherited: Первый индекс в списке, который удовлетворяет предоставленному условию test.
insert(int index, E element) → void inherited: Вставляет element в позицию index в этом списке.
insertAll(int index, Iterable<E> iterable) → void inherited: Вставляет все элементы iterable в позицию index в этом списке.
join([String separator = ""]) → String inherited: Преобразует каждый элемент в String и конкатенирует строки.
lastIndexOf(Object? element, [int? start]) → int inherited: Последний индекс element в этом списке.
lastIndexWhere(bool test(E element), [int? start]) → int inherited: Последний индекс в списке, который удовлетворяет предоставленному условию test.
lastWhere(bool test(E element), {E orElse()?}) → E inherited: Возвращает последний элемент, удовлетворяющий заданному предикату test.
map<T>(T f(E element)) → Iterable<T> inherited: Текущие элементы этого итерируемого объекта, изменённые функцией toElement.
noSuchMethod(Invocation invocation) → dynamic inherited: Вызывается, когда обращаются к несуществующему методу или свойству.
reduce(E combine(E previousValue, E element)) → E inherited: Сводит коллекцию к одному значению, итеративно комбинируя элементы коллекции с помощью предоставленной функции.
remove(Object? element) → bool inherited: Удаляет первое вхождение value из этого списка.
removeAt(int index) → E inherited: Удаляет элемент в позиции index из этого списка.
removeLast() → E inherited: Удаляет и возвращает последний элемент в этом списке.
removeRange(int start, int end) → void inherited: Удаляет диапазон элементов из списка.
removeWhere(bool test(E element)) → void inherited: Удаляет все элементы из этого списка, которые удовлетворяют условию test.
replaceRange(int start, int end, Iterable<E> newContents) → void inherited: Заменяет диапазон элементов элементами replacements.
retainWhere(bool test(E element)) → void inherited: Удаляет все элементы из этого списка, которые не удовлетворяют условию test.
setAll(int index, Iterable<E> iterable) → void inherited: Заменяет элементы элементами iterable.
setRange(int start, int end, Iterable<E> iterable, [int skipCount = 0]) → void inherited: Записывает некоторые элементы iterable в диапазон этого списка.
shuffle([Random? random]) → void inherited: Случайно перемешивает элементы этого списка.
singleWhere(bool test(E element), {E orElse()?}) → E inherited

Возвращает единственный элемент, удовлетворяющий test.
skip(int count) → Iterable<E> inherited: Возвращает Iterable, содержащий все элементы, кроме первых count элементов.
skipWhile(bool test(E element)) → Iterable<E> inherited: Возвращает Iterable, пропускающий начальные элементы, пока test выполняется.
sort([int compare(E a, E b)?]) → void inherited: Сортирует этот список в порядке, заданном функцией compare.
sublist(int start, [int? end]) → List<E> inherited: Возвращает новый список, содержащий элементы между start и end.
take(int count) → Iterable<E> inherited: Возвращает ленивый итератор первых count элементов этого итератора.
takeWhile(bool test(E element)) → Iterable<E> inherited: Возвращает ленивый итератор начальных элементов, удовлетворяющих test.
toList({bool growable = true}) → List<E> inherited: Создаёт List, содержащую элементы этого Iterable.
toSet() → Set<E> inherited: Создаёт Set, содержащий те же элементы, что и этот итератор.
toString() → String inherited: Строковое представление этого объекта.
where(bool test(E element)) → Iterable<E> inherited: Возвращает новый ленивый Iterable со всеми элементами, удовлетворяющими предикату test.
whereType<T>() → Iterable<T> inherited: Возвращает новый ленивый Iterable со всеми элементами типа T.

Операторы

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

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

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.18.5/dart-collection/ListBase-class.html