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(
bool 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(
bool test(E element)) → bool -
Checks whether every element of this iterable satisfies
test.… -
expand(
Iterable 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(
bool test(E element), {E orElse()}) → E -
Returns the first element that satisfies the given predicate
test.… -
fold(
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…
-
forEach(
void 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(
bool test(E element), {E orElse()}) → E -
Returns the last element that satisfies the given predicate
test.… -
map(
dynamic 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(
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.…
-
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(
bool 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(
bool 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(
bool test(E element)) → E -
Returns the single element that satisfies
test.… -
skip(
int count) → Iterable<E> -
Returns an
Iterablethat provides all but the firstcountelements.… -
skipWhile(
bool test(E element)) → Iterable<E> -
Returns an
Iterablethat skips leading elements whiletestis satisfied.… -
sort(
[int 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(
bool 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(
bool test(E element)) → Iterable<E> -
Returns a new lazy
Iterablewith all elements that satisfy the predicatetest.…