ListBase<E> class

Abstract implementation of a list.

Abstract implementation of a list.

ListBase can be used as a base class for implementing the List interface.

All operations are defined in terms of length, operator[], operator[]= and length=, which need to be implemented.

NOTICE: Forwarding just these four operations to a normal growable List (as created by new List()) will give very bad performance for add and addAll operations of ListBase. These operations are implemented by increasing the length of the list by one for each add operation, and repeatedly increasing the length of a growable list is not efficient. To avoid this, either override 'add' and 'addAll' to also forward directly to the growable list, or, preferably, use DelegatingList from "package:collection/wrappers.dart" instead.

Mixes-in:
Implementors

Constructors

ListBase ( )

Static Methods

listToString ( List list ) → String
Convert a List to a string as each, element, as, string.

Instance Properties

iterator Iterator<E> Inherited
read-only
isEmpty bool Inherited
read-only
isNotEmpty bool Inherited
read-only
first E Inherited
read-only
last E Inherited
read-only
single E Inherited
read-only
reversed Iterable<E> Inherited
read-only
last E Inherited
read-only
single E Inherited
read-only
length int Inherited
read/write
reversed Iterable<E> Inherited
read-only
iterator Iterator<E> Inherited
read-only
first E Inherited
read-only

Instance Methods

toString Inherited ( ) → String
Returns a string representation of this object.
elementAt Inherited ( int index ) → E
Returns the [index]th element.
forEach Inherited ( void action(E element) ) → void
Applies the function [f] to each element of this collection in iteration order.
contains Inherited ( Object element ) → bool
Returns true if the collection contains an element equal to [element].
every Inherited ( bool test(E element) ) → bool
Checks whether every element of this iterable satisfies [test].
any Inherited ( bool test(E element) ) → bool
Checks whether any element of this iterable satisfies [test].
firstWhere Inherited ( bool test(E element), {E orElse()} ) → E
Returns the first element that satisfies the given predicate [test].
lastWhere Inherited ( bool test(E element), {E orElse()} ) → E
Returns the last element that satisfies the given predicate [test].
singleWhere Inherited ( bool test(E element) ) → E
Returns the single element that satisfies [test].
join Inherited ( [String separator = ""] ) → String
Converts each element to a [String] and concatenates the strings.
where Inherited ( bool test(E element) ) → Iterable<E>
Returns a new lazy [Iterable] with all elements that satisfy the predicate [test].
map Inherited ( dynamic f(E element) ) → Iterable
Returns a new lazy [Iterable] with elements that are created by calling f on each element of this Iterable in iteration order.
expand Inherited ( Iterable f(E element) ) → Iterable
Expands each element of this [Iterable]into zero or more elements.
reduce Inherited ( E combine(E previousValue, E element) ) → E
Reduces a collection to a single value by iteratively combining elements of the collection using the provided function.
fold Inherited ( initialValue, dynamic combine(previousValue, E element) ) → dynamic
Reduces a collection to a single value by iteratively combining each element of the collection with an existing value
skip Inherited ( int count ) → Iterable<E>
Returns an Iterable that provides all but the first [count] elements.
skipWhile Inherited ( bool test(E element) ) → Iterable<E>
Returns an Iterable that skips leading elements while [test] is satisfied.
take Inherited ( int count ) → Iterable<E>
Returns a lazy iterable of the [count] first elements of this iterable.
takeWhile Inherited ( bool test(E element) ) → Iterable<E>
Returns a lazy iterable of the leading elements satisfying [test].
toList Inherited ( {bool growable: true} ) → List<E>
Creates a [List] containing the elements of this [Iterable].
toSet Inherited ( ) → Set<E>
Creates a [Set] containing the same elements as this iterable.
add Inherited ( E element ) → void
Adds [value] to the end of this list, extending the length by one.
addAll Inherited ( Iterable<E> iterable ) → void
Appends all objects of [iterable] to the end of this list.
remove Inherited ( Object element ) → bool
Removes the first occurence of [value] from this list.
removeWhere Inherited ( bool test(E element) ) → void
Removes all objects from this list that satisfy [test].
retainWhere Inherited ( bool test(E element) ) → void
Removes all objects from this list that fail to satisfy [test].
clear Inherited ( ) → void
Removes all objects from this list; the length of the list becomes zero.
removeLast Inherited ( ) → E
Pops and returns the last object in this list.
sort Inherited ( [int compare(E a, E b)] ) → void
Sorts this list according to the order specified by the [compare] function.
shuffle Inherited ( [Random random] ) → void
Shuffles the elements of this list randomly.
asMap Inherited ( ) → Map<int,E>
Returns an unmodifiable [Map] view of this.
sublist Inherited ( int start, [int end] ) → List<E>
Returns a new list containing the objects from [start] inclusive to [end] exclusive.
getRange Inherited ( int start, int end ) → Iterable<E>
Returns an [Iterable] that iterates over the objects in the range [start] inclusive to [end] exclusive.
removeRange Inherited ( int start, int end ) → void
Removes the objects in the range [start] inclusive to [end] exclusive.
fillRange Inherited ( int start, int end, [E fill] ) → void
Sets the objects in the range [start] inclusive to [end] exclusive to the given [fillValue].
setRange Inherited ( int start, int end, Iterable<E> iterable, [int skipCount = 0] ) → void
Copies the objects of [iterable], skipping [skipCount] objects first, into the range [start], inclusive, to [end], exclusive, of the list.
replaceRange Inherited ( int start, int end, Iterable<E> newContents ) → void
Removes the objects in the range [start] inclusive to [end] exclusive and inserts the contents of [replacement] in its place.
indexOf Inherited ( Object element, [int startIndex = 0] ) → int
Returns the first index of [element] in this list.
lastIndexOf Inherited ( Object element, [int startIndex] ) → int
Returns the last index in the list a of the given element, starting the search at index startIndex to 0. Returns -1 if element is not found.
insert Inherited ( int index, E element ) → void
Inserts the object at position [index] in this list.
removeAt Inherited ( int index ) → E
Removes the object at position [index] from this list.
insertAll Inherited ( int index, Iterable<E> iterable ) → void
Inserts all objects of [iterable] at position [index] in this list.
setAll Inherited ( int index, Iterable<E> iterable ) → void
Overwrites objects of this with the objects of [iterable], starting at position [index] in this list.
insert Inherited ( int index, E element ) → void
Inserts the object at position [index] in this list.
take Inherited ( int count ) → Iterable<E>
Returns a lazy iterable of the [count] first elements of this iterable.
map Inherited ( dynamic f(E element) ) → Iterable
Returns a new lazy [Iterable] with elements that are created by calling f on each element of this Iterable in iteration order.
toSet Inherited ( ) → Set<E>
Creates a [Set] containing the same elements as this iterable.
forEach Inherited ( void action(E element) ) → void
Applies the function [f] to each element of this collection in iteration order.
setAll Inherited ( int index, Iterable<E> iterable ) → void
Overwrites objects of this with the objects of [iterable], starting at position [index] in this list.
skipWhile Inherited ( bool test(E element) ) → Iterable<E>
Returns an Iterable that skips leading elements while [test] is satisfied.
setRange Inherited ( int start, int end, Iterable<E> iterable, [int skipCount = 0] ) → void
Copies the objects of [iterable], skipping [skipCount] objects first, into the range [start], inclusive, to [end], exclusive, of the list.
asMap Inherited ( ) → Map<int,E>
Returns an unmodifiable [Map] view of this.
lastWhere Inherited ( bool test(E element), {E orElse()} ) → E
Returns the last element that satisfies the given predicate [test].
reduce Inherited ( E combine(E previousValue, E element) ) → E
Reduces a collection to a single value by iteratively combining elements of the collection using the provided function.
every Inherited ( bool test(E element) ) → bool
Checks whether every element of this iterable satisfies [test].
any Inherited ( bool test(E element) ) → bool
Checks whether any element of this iterable satisfies [test].
where Inherited ( bool test(E element) ) → Iterable<E>
Returns a new lazy [Iterable] with all elements that satisfy the predicate [test].
sort Inherited ( [int compare(E a, E b)] ) → void
Sorts this list according to the order specified by the [compare] function.
skip Inherited ( int count ) → Iterable<E>
Returns an Iterable that provides all but the first [count] elements.
expand Inherited ( Iterable f(E element) ) → Iterable
Expands each element of this [Iterable]into zero or more elements.
elementAt Inherited ( int index ) → E
Returns the [index]th element.
getRange Inherited ( int start, int end ) → Iterable<E>
Returns an [Iterable] that iterates over the objects in the range [start] inclusive to [end] exclusive.
removeAt Inherited ( int index ) → E
Removes the object at position [index] from this list.
takeWhile Inherited ( bool test(E element) ) → Iterable<E>
Returns a lazy iterable of the leading elements satisfying [test].
fold Inherited ( initialValue, dynamic combine(previousValue, E element) ) → dynamic
Reduces a collection to a single value by iteratively combining each element of the collection with an existing value
sublist Inherited ( int start, [int end] ) → List<E>
Returns a new list containing the objects from [start] inclusive to [end] exclusive.
firstWhere Inherited ( bool test(E element), {E orElse()} ) → E
Returns the first element that satisfies the given predicate [test].
add Inherited ( E element ) → void
Adds [value] to the end of this list, extending the length by one.
singleWhere Inherited ( bool test(E element) ) → E
Returns the single element that satisfies [test].
addAll Inherited ( Iterable<E> iterable ) → void
Appends all objects of [iterable] to the end of this list.
replaceRange Inherited ( int start, int end, Iterable<E> newContents ) → void
Removes the objects in the range [start] inclusive to [end] exclusive and inserts the contents of [replacement] in its place.
insertAll Inherited ( int index, Iterable<E> iterable ) → void
Inserts all objects of [iterable] at position [index] in this list.
removeWhere Inherited ( bool test(E element) ) → void
Removes all objects from this list that satisfy [test].
toList Inherited ( {bool growable: true} ) → List<E>
Creates a [List] containing the elements of this [Iterable].
fillRange Inherited ( int start, int end, [E fill] ) → void
Sets the objects in the range [start] inclusive to [end] exclusive to the given [fillValue].
removeLast Inherited ( ) → E
Pops and returns the last object in this list.
retainWhere Inherited ( bool test(E element) ) → void
Removes all objects from this list that fail to satisfy [test].

Operators

operator []= Inherited ( int index, E value ) → void
Sets the value at the given index in the list to value or throws a RangeError if index is out of bounds.
operator [] Inherited ( int index ) → E
Returns the object at the given index in the list or throws a RangeError if index is out of bounds.