DelegatingList<E> class

A List that delegates all operations to a base list.

This class can be used to hide non-List methods of a list object, or it can be extended to add extra functionality on top of an existing list object.

Implemented types

• List<E>
• Iterable<E>

Available extensions

• ChunkedOnIterableExtension
• EnumByName
• FutureIterable
• GenericTypeOnIterableExtension
• IterableComparableExtension
• IterableDoubleExtension
• IterableExtension
• IterableExtensions
• IterableIntegerExtension
• IterableIterableExtension
• IterableNullableExtension
• IterableNumberExtension
• JoinWithLastSeparatorOnIterableExtension
• ListComparableExtensions
• ListExtensions
• ListToJSArray
• MaybeAddToIterableExtension
• MaybeAddToListExtension
• NullableIterableExtensions
• NullIfEmptyOnIterableExtension
• NullIfEmptyOnListExtension
• SecondToNinthElementOnIterableExtension
• TakeLastOnIterableExtension
• ToMapOnIterableExtension
• TryMergeOnIterableExtension
• TryReduceOnIterableExtension
• UniqueOnMapEntryIterableExtension
• ValueOfOnEnumExtension

Constructors

DelegatingList(List<E> base)

const

Properties

first ↔ E

The first element.

getter/setter pair, inherited-getter, override-setter

hashCode → int

The hash code for this object.

no setter, inherited

isEmpty → bool

Whether this collection has no elements.

no setter, inherited

isNotEmpty → bool

Whether this collection has at least one element.

no setter, inherited

iterator → Iterator<E>

A new Iterator that allows iterating the elements of this Iterable.

no setter, inherited

last ↔ E

The last element.

getter/setter pair, inherited-getter, override-setter

length ↔ int

The number of elements in this Iterable.

getter/setter pair, inherited-getter, override-setter

reversed → Iterable<E>

An Iterable of the objects in this list in reverse order.

no setter, override

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

single → E

Checks that this iterable has only one element, and returns that element.

no setter, inherited

Methods

add(E value) → void

Adds value to the end of this list, extending the length by one.

override

addAll(Iterable<E> iterable) → void

Appends all objects of iterable to the end of this list.

override

any(bool test(E)) → bool

Checks whether any element of this iterable satisfies test.

inherited

asMap() → Map<int, E>

An unmodifiable Map view of this list.

override

cast<T>() → List<T>

A view of this iterable as an iterable of R instances.

clear() → void

Removes all objects from this list; the length of the list becomes zero.

override

contains(Object? element) → bool

Whether the collection contains an element equal to element.

inherited

elementAt(int index) → E

Returns the indexth element.

inherited

every(bool test(E)) → bool

Checks whether every element of this iterable satisfies test.

inherited

expand<T>(Iterable<T> f(E)) → Iterable<T>

Expands each element of this Iterable into zero or more elements.

inherited

fillRange(int start, int end, [E? fillValue]) → void

Overwrites a range of elements with fillValue.

override

firstWhere(bool test(E), {E orElse()?}) → E

The first element that satisfies the given predicate test.

inherited

fold<T>(T initialValue, T combine(T previousValue, E element)) → T

Reduces a collection to a single value by iteratively combining each element of the collection with an existing value

inherited

followedBy(Iterable<E> other) → Iterable<E>

Creates the lazy concatenation of this iterable and other.

inherited

forEach(void f(E)) → void

Invokes action on each element of this iterable in iteration order.

inherited

getRange(int start, int end) → Iterable<E>

Creates an Iterable that iterates over a range of elements.

override

indexOf(E element, [int start = 0]) → int

The first index of element in this list.

override

indexWhere(bool test(E), [int start = 0]) → int

The first index in the list that satisfies the provided test.

override

insert(int index, E element) → void

Inserts element at position index in this list.

override

insertAll(int index, Iterable<E> iterable) → void

Inserts all objects of iterable at position index in this list.

override

join([String separator = '']) → String

Converts each element to a String and concatenates the strings.

inherited

lastIndexOf(E element, [int? start]) → int

The last index of element in this list.

override

lastIndexWhere(bool test(E), [int? start]) → int

The last index in the list that satisfies the provided test.

override

lastWhere(bool test(E), {E orElse()?}) → E

The last element that satisfies the given predicate test.

inherited

map<T>(T f(E)) → Iterable<T>

The current elements of this iterable modified by toElement.

inherited

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

reduce(E combine(E value, E element)) → E

Reduces a collection to a single value by iteratively combining elements of the collection using the provided function.

inherited

remove(Object? value) → bool

Removes the first occurrence of value from this list.

override

removeAt(int index) → E

Removes the object at position index from this list.

override

removeLast() → E

Removes and returns the last object in this list.

override

removeRange(int start, int end) → void

Removes a range of elements from the list.

override

removeWhere(bool test(E)) → void

Removes all objects from this list that satisfy test.

override

replaceRange(int start, int end, Iterable<E> iterable) → void

Replaces a range of elements with the elements of replacements.

override

retainWhere(bool test(E)) → void

Removes all objects from this list that fail to satisfy test.

override

retype<T>() → List<T>

setAll(int index, Iterable<E> iterable) → void

Overwrites elements with the objects of iterable.

override

setRange(int start, int end, Iterable<E> iterable, [int skipCount = 0]) → void

Writes some elements of iterable into a range of this list.

override

shuffle([Random? random]) → void

Shuffles the elements of this list randomly.

override

singleWhere(bool test(E), {E orElse()?}) → E

The single element that satisfies test.

inherited

skip(int n) → Iterable<E>

Creates an Iterable that provides all but the first count elements.

inherited

skipWhile(bool test(E)) → Iterable<E>

Creates an Iterable that skips leading elements while test is satisfied.

inherited

sort([int compare(E, E)?]) → void

Sorts this list according to the order specified by the compare function.

override

sublist(int start, [int? end]) → List<E>

Returns a new list containing the elements between start and end.

override

take(int n) → Iterable<E>

Creates a lazy iterable of the count first elements of this iterable.

inherited

takeWhile(bool test(E)) → Iterable<E>

Creates a lazy iterable of the leading elements satisfying test.

inherited

toList({bool growable = true}) → List<E>

Creates a List containing the elements of this Iterable.

inherited

toSet() → Set<E>

Creates a Set containing the same elements as this iterable.

inherited

toString() → String

A string representation of this object.

inherited

where(bool test(E)) → Iterable<E>

Creates a new lazy Iterable with all elements that satisfy the predicate test.

inherited

whereType<T>() → Iterable<T>

Creates a new lazy Iterable with all elements that have type T.

inherited

Operators

operator +(List<E> other) → List<E>

Returns the concatenation of this list and other.

override

operator ==(Object other) → bool

The equality operator.

inherited

operator [](int index) → E

The object at the given index in the list.

override

operator []=(int index, E value) → void

Sets the value at the given index in the list to value.

override

Static Methods

typed<E>(List base) → List<E>

Creates a wrapper that asserts the types of values in base.