Base implementation of a List class.
ListMixin can be used as a mixin to make a class implement
the List interface.
This implements all read operations using only the length and
operator[] members. It implements write operations using those and
length= and operator[]=
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, if possible, use DelegatingList from
"package:collection/wrappers.dart" instead.
Constructors
Properties
- first → E
-
read-only
- hashCode → int
-
Get a hash code for this object.…
read-only, inherited - isEmpty → bool
-
read-only
- isNotEmpty → bool
-
read-only
- iterator → Iterator<E>
-
read-only
- last → E
-
read-only
- length → int
-
Returns the number of objects in this list.…
read / write, inherited - reversed → Iterable<E>
-
read-only
- runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited - single → E
-
read-only
Operators
-
operator ==(
other) → bool -
The equality operator.…
inherited -
operator [](
int index) → E -
Returns the object at the given
indexin the list or throws a RangeError ifindexis out of bounds.inherited -
operator []=(
int index, E value) → void -
Sets the value at the given
indexin the list tovalueor throws a RangeError ifindexis out of bounds.inherited
Methods
-
add(
E element) → void -
Adds
valueto the end of this list, extending the length by one.… -
addAll(
Iterable<E> iterable) → void -
Appends all objects of
iterableto the end of this list.… -
any(
test(E element)) → bool -
Checks whether any element of this iterable satisfies
test.… -
asMap(
) → Map<int, E> -
Returns an unmodifiable
Mapview ofthis.… -
clear(
) → void -
Removes all objects from this list; the length of the list becomes zero.…
-
contains(
Object element) → bool -
Returns true if the collection contains an element equal to
element.… -
elementAt(
int index) → E -
Returns the
indexth element.… -
every(
test(E element)) → bool -
Checks whether every element of this iterable satisfies
test.… -
expand(
f(E element)) → Iterable -
Expands each element of this
Iterableinto zero or more elements.… -
fillRange(
int start, int end, [E fill]) → void -
Sets the objects in the range
startinclusive toendexclusive to the givenfillValue.… -
firstWhere(
test(E element), { orElse()}) → E -
Returns the first element that satisfies the given predicate
test.… -
fold(
initialValue, combine(previousValue, E element)) → dynamic -
Reduces a collection to a single value by iteratively combining each element of the collection with an existing value…
-
forEach(
action(E element)) → void -
Applies the function
fto each element of this collection in iteration order. -
getRange(
int start, int end) → Iterable<E> -
Returns an
Iterablethat iterates over the objects in the rangestartinclusive toendexclusive.… -
indexOf(
Object element, [int startIndex = 0]) → int -
Returns the first index of
elementin this list.… -
insert(
int index, E element) → void -
Inserts the object at position
indexin this list.… -
insertAll(
int index, Iterable<E> iterable) → void -
Inserts all objects of
iterableat positionindexin this list.… -
join(
[String separator = ""]) → String -
Converts each element to a
Stringand concatenates the strings.… -
lastIndexOf(
Object element, [int startIndex]) → int -
Returns the last index in the list
aof the givenelement, starting the search at indexstartIndexto 0. Returns -1 ifelementis not found. -
lastWhere(
test(E element), { orElse()}) → E -
Returns the last element that satisfies the given predicate
test.… -
map(
f(E element)) → Iterable -
Returns a new lazy
Iterablewith elements that are created by callingfon each element of thisIterablein iteration order.… -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed.…
inherited -
reduce(
combine(E previousValue, E element)) → E -
Reduces a collection to a single value by iteratively combining elements of the collection using the provided function.…
-
remove(
Object element) → bool -
Removes the first occurence of
valuefrom this list.… -
removeAt(
int index) → E -
Removes the object at position
indexfrom this list.… -
removeLast(
) → E -
Pops and returns the last object in this list.…
-
removeRange(
int start, int end) → void -
Removes the objects in the range
startinclusive toendexclusive.… -
removeWhere(
test(E element)) → void -
Removes all objects from this list that satisfy
test.… -
replaceRange(
int start, int end, Iterable<E> newContents) → void -
Removes the objects in the range
startinclusive toendexclusive and inserts the contents ofreplacementin its place.… -
retainWhere(
test(E element)) → void -
Removes all objects from this list that fail to satisfy
test.… -
setAll(
int index, Iterable<E> iterable) → void -
Overwrites objects of
thiswith the objects ofiterable, starting at positionindexin this list.… -
setRange(
int start, int end, Iterable<E> iterable, [int skipCount = 0]) → void -
Copies the objects of
iterable, skippingskipCountobjects first, into the rangestart, inclusive, toend, exclusive, of the list.… -
shuffle(
[Random random]) → void -
Shuffles the elements of this list randomly.
-
singleWhere(
test(E element)) → E -
Returns the single element that satisfies
test.… -
skip(
int count) → Iterable<E> -
Returns an Iterable that provides all but the first
countelements.… -
skipWhile(
test(E element)) → Iterable<E> -
Returns an Iterable that skips leading elements while
testis satisfied.… -
sort(
[ compare(E a, E b)]) → void -
Sorts this list according to the order specified by the
comparefunction.… -
sublist(
int start, [int end]) → List<E> -
Returns a new list containing the objects from
startinclusive toendexclusive.… -
take(
int count) → Iterable<E> -
Returns a lazy iterable of the
countfirst elements of this iterable.… -
takeWhile(
test(E element)) → Iterable<E> -
Returns a lazy iterable of the leading elements satisfying
test.… -
toList(
{bool growable: true}) → List<E> -
Creates a
Listcontaining the elements of thisIterable.… -
toSet(
) → Set<E> -
Creates a
Setcontaining the same elements as this iterable.… -
toString(
) → String -
Returns a string representation of this object.
-
where(
test(E element)) → Iterable<E> -
Returns a new lazy
Iterablewith all elements that satisfy the predicatetest.…