ListMixin абстрактный класс
Базовое реализация класса List.
ListMixin может быть использован как миксин, чтобы сделать класс реализующим интерфейс List.
Этот класс реализует все операции чтения, используя только члены length и operator[]. Он реализует операции записи, используя эти члены и length= и operator[]=.
ПРИМЕЧАНИЕ: Перенаправление только этих четырёх операций на обычный изменяемый List (созданный с помощью new List()) даст очень плохую производительность для операций add и addAll ListBase. Эти операции реализуются увеличением длины списка на единицу для каждой операции add, а многократное увеличение длины изменяемого списка не эффективно. Чтобы избежать этого, переопределите 'add' и 'addAll', чтобы также напрямую перенаправлять на изменяемый список, или, если возможно, используйте DelegatingList из "package:collection/wrappers.dart".
- Реализует
-
- List<E>
- Реализован в
Конструкторы
- ListMixin()
Свойства
- first → E только для чтения
- isEmpty → bool только для чтения
- isNotEmpty → bool только для чтения
- iterator → Iterator<E> только для чтения
- last → E только для чтения
- reversed → Iterable<E> только для чтения
- single → E только для чтения
- hashCode → int только для чтения, унаследованно
-
Хеш-код для этого объекта.
- length → int чтение/запись, унаследованно
-
Возвращает количество объектов в этом списке.
- runtimeType → Type только для чтения, унаследованно
-
Представление типа объекта во время выполнения.
Операторы
- operator ==(
other) → bool унаследованно -
Оператор равенства.
- operator [](
int index) → E унаследованно -
Возвращает объект по заданному
indexв списке или выбрасывает RangeError, еслиindexнаходится вне границ. - operator []=(
int index, E value) → void унаследованно -
Устанавливает значение по заданному
indexв списке наvalueили выбрасывает RangeError, еслиindexнаходится вне границ.
Методы
- add(
E element) → void -
Добавляет
valueв конец этого списка, увеличивая его длину на единицу. - addAll(
Iterable<E> iterable) → void -
Добавляет все объекты из
iterableв конец этого списка. - any(
bool test(E element)) → bool -
Проверяет, удовлетворяет ли какой-либо элемент этого итерируемого объекта
test. - asMap(
) → Map<int, E> -
Возвращает неизменяемый
Mapвидthis. - clear(
) → void -
Удаляет все объекты из этого списка; длина списка становится равной нулю.
- contains(
Object element) → bool -
Возвращает true, если коллекция содержит элемент, равный
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 -
Устанавливает объекты в диапазоне
startвключительно доendисключая, заданномуfillValue. - firstWhere(
bool test(E element), { E orElse() }) → E -
Возвращает первый элемент, удовлетворяющий заданному предикату
test. - fold<T>(
T initialValue, T combine(T previousValue, E element)) → T -
Сводит коллекцию к одному значению, итеративно комбинируя каждый элемент коллекции с существующим значением
- forEach(
void action(E element)) → void -
Применяет функцию
fк каждому элементу этого набора в порядке итерации. - getRange(
int start, int end) → Iterable<E> -
Возвращает
Iterable, который итерируется по объектам в диапазонеstartвключительно доendисключая. - indexOf(
Object element, [ int startIndex = 0 ]) → int -
Возвращает первый индекс
elementв этом списке. - insert(
int index, E element) → void -
Вставляет объект в позицию
indexв этот список. - insertAll(
int index, Iterable<E> iterable) → void -
Вставляет все объекты из
iterableв позициюindexв этот список. - join(
[String separator = "" ]) → String -
Преобразует каждый элемент в
Stringи конкатенирует строки. - lastIndexOf(
Object element, [ int startIndex ]) → int -
Возвращает последний индекс в списке
aзаданногоelement, начиная поиск с индексаstartIndexдо 0. Возвращает -1, еслиelementне найден. - lastWhere(
bool test(E element), { E orElse() }) → E -
Возвращает последний элемент, удовлетворяющий заданному предикату
test. - map<T>(
T f(E element)) → Iterable<T> -
Возвращает новый ленивый
Iterableс элементами, созданными путем вызоваfдля каждого элемента этогоIterableв порядке итерации. - 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 -
Удаляет объекты в диапазоне
startвключительно доendисключая. - removeWhere(
bool test(E element)) → void -
Удаляет все объекты из этого списка, удовлетворяющие
test. - replaceRange(
int start, int end, Iterable<E> newContents) → void -
Удаляет объекты в диапазоне
startвключительно доendисключая и вставляет содержимоеreplacementна его место. - retainWhere(
bool test(E element)) → void -
Удаляет все объекты из этого списка, которые не удовлетворяют
test. - setAll(
int index, Iterable<E> iterable) → void -
Перезаписывает объекты из
thisобъектами изiterable, начиная с позицииindexв этом списке. - setRange(
int start, int end, Iterable<E> iterable, [ int skipCount = 0 ]) → void -
Копирует объекты из
iterable, пропускаяskipCountобъектов сначала, в диапазонstart, включительно, доend, исключая, списка. - shuffle(
[Random random ]) → void -
Случайным образом перемешивает элементы этого списка.
- singleWhere(
bool test(E element)) → 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. - noSuchMethod(
Invocation invocation) → dynamic inherited -
Вызывается при обращении к несуществующему методу или свойству.
© 2012 the Dart project authors
Licensed under the Creative Commons Attribution-ShareAlike License v4.0.
https://api.dartlang.org/stable/1.24.3/dart-collection/ListMixin-class.html