An indexable collection of objects with a length.
Subclasses of this class implement different kinds of lists. The most common kinds of lists are:
-
Fixed-length list
An error occurs when attempting to use operations that can change the length of the list.
-
Growable list
Full implementation of the API defined in this class.
The default growable list, as created by []
, keeps
an internal buffer, and grows that buffer when necessary. This guarantees
that a sequence of add operations will each execute in amortized constant
time. Setting the length directly may take time proportional to the new
length, and may change the internal capacity so that a following add
operation will need to immediately increase the buffer capacity.
Other list implementations may have different performance behavior.
Example of fixed-length list:
final fixedLengthList = List<int>.filled(5, 0); // Creates fixed-length list.
print(fixedLengthList); // [0, 0, 0, 0, 0]
fixedLengthList[0] = 87;
fixedLengthList.setAll(1, [1, 2, 3]);
print(fixedLengthList); // [87, 1, 2, 3, 0]
// Fixed length list length can't be changed or increased
fixedLengthList.length = 0; // Throws
fixedLengthList.add(499); // Throws
Example of growable list:
final growableList = <String>['A', 'B']; // Creates growable list.
To add data to the growable list, use operator[]=, add or addAll.
growableList[0] = 'G';
print(growableList); // [G, B]
growableList.add('X');
growableList.addAll({'C', 'B'});
print(growableList); // [G, B, X, C, B]
To check whether, and where, the element is in the list, use indexOf or lastIndexOf.
final indexA = growableList.indexOf('A'); // -1 (not in the list)
final firstIndexB = growableList.indexOf('B'); // 1
final lastIndexB = growableList.lastIndexOf('B'); // 4
To remove an element from the growable list, use remove, removeAt, removeLast, removeRange or removeWhere.
growableList.remove('C');
growableList.removeLast();
print(growableList); // [G, B, X]
To insert an element at position in the list, use insert or insertAll.
growableList.insert(1, 'New');
print(growableList); // [G, New, B, X]
To replace a range of elements in the list, use fillRange, replaceRange or setRange.
growableList.replaceRange(0, 2, ['AB', 'A']);
print(growableList); // [AB, A, B, X]
growableList.fillRange(2, 4, 'F');
print(growableList); // [AB, A, F, F]
To sort the elements of the list, use sort.
growableList.sort((a, b) => a.compareTo(b));
print(growableList); // [A, AB, F, F]
To shuffle the elements of this list randomly, use shuffle.
growableList.shuffle();
print(growableList); // e.g. [AB, F, A, F]
To find the first element satisfying some predicate, or give a default value if none do, use firstWhere.
bool isVowel(String char) => char.length == 1 && "AEIOU".contains(char);
final firstVowel = growableList.firstWhere(isVowel, orElse: () => ''); // ''
There are similar lastWhere and singleWhere methods.
A list is an Iterable and supports all its methods, including where, map, whereType and toList.
Lists are Iterable. Iteration occurs over values in index order. Changing the values does not affect iteration, but changing the valid indices—that is, changing the list's length—between iteration steps causes a ConcurrentModificationError. This means that only growable lists can throw ConcurrentModificationError. If the length changes temporarily and is restored before continuing the iteration, the iterator might not detect it.
It is generally not allowed to modify the list's length (adding or removing elements) while an operation on the list is being performed, for example during a call to forEach or sort. Changing the list's length while it is being iterated, either by iterating it directly or through iterating an Iterable that is backed by the list, will break the iteration.
- Implemented types
-
- Iterable<
E>
- Iterable<
- Implementers
- Available extensions
Constructors
- List.empty({bool growable = false})
-
Creates a new empty list.
factory
- List.filled(int length, E fill, {bool growable = false})
-
Creates a list of the given length with
fill
at each position.factory - List.from(Iterable elements, {bool growable = true})
-
Creates a list containing all
elements
.factory - List.generate(int length, E generator(int index), {bool growable = true})
-
Generates a list of values.
factory
-
List.of(Iterable<
E> elements, {bool growable = true}) -
Creates a list from
elements
.factory - List.unmodifiable(Iterable elements)
-
Creates an unmodifiable list containing all
elements
.factory
Properties
- average → double
-
Available on Iterable<
The arithmetic mean of the elements of a non-empty iterable.int> , provided by the IterableIntegerExtension extensionno setter - average → double
-
Available on Iterable<
The arithmetic mean of the elements of a non-empty iterable.num> , provided by the IterableNumberExtension extensionno setter - first ↔ E
-
The first element.
getter/setter pairinherited-getter
- firstOrNull → T?
-
Available on Iterable<
The first element, orT> , provided by the IterableExtension extensionnull
if the iterable is empty.no setter - firstOrNull → T?
-
Available on Iterable<
The first element of this iterator, orT> , provided by the IterableExtensions extensionnull
if the iterable is empty.no setter -
flattened
→ Iterable<
T> -
Available on Iterable<
The sequential elements of each iterable in this iterable.Iterable< , provided by the IterableIterableExtension extensionT> >no setter -
flattenedToList
→ List<
T> -
Available on Iterable<
The sequential elements of each iterable in this iterable.Iterable< , provided by the IterableIterableExtension extensionT> >no setter -
flattenedToSet
→ Set<
T> -
Available on Iterable<
The unique sequential elements of each iterable in this iterable.Iterable< , provided by the IterableIterableExtension extensionT> >no setter - hashCode → int
-
The hash code for this object.
no setterinherited
-
indexed
→ Iterable<
(int, T)> -
Available on Iterable<
Pairs of elements of the indices and elements of this iterable.T> , provided by the IterableExtensions extensionno setter - isEmpty → bool
-
Whether this collection has no elements.
no setterinherited
- isNotEmpty → bool
-
Whether this collection has at least one element.
no setterinherited
-
iterator
→ Iterator<
E> -
A new
Iterator
that allows iterating the elements of thisIterable
.no setterinherited - last ↔ E
-
The last element.
getter/setter pairinherited-getter
- lastOrNull → T?
-
Available on Iterable<
The last element, orT> , provided by the IterableExtension extensionnull
if the iterable is empty.no setter - lastOrNull → T?
-
Available on Iterable<
The last element of this iterable, orT> , provided by the IterableExtensions extensionnull
if the iterable is empty.no setter - length ↔ int
-
The number of objects in this list.
getter/setter pairoverride-getter
- max → num
-
Available on Iterable<
A maximal element of the iterable.num> , provided by the IterableNumberExtension extensionno setter - max → T
-
Available on Iterable<
A maximal element of the iterable.T> , provided by the IterableComparableExtension extensionno setter - max → double
-
Available on Iterable<
A maximal element of the iterable.double> , provided by the IterableDoubleExtension extensionno setter - max → int
-
Available on Iterable<
A maximal element of the iterable.int> , provided by the IterableIntegerExtension extensionno setter - maxOrNull → int?
-
Available on Iterable<
A maximal element of the iterable, orint> , provided by the IterableIntegerExtension extensionnull
if the iterable is empty.no setter - maxOrNull → double?
-
Available on Iterable<
A maximal element of the iterable, ordouble> , provided by the IterableDoubleExtension extensionnull
if the iterable is empty.no setter - maxOrNull → T?
-
Available on Iterable<
A maximal element of the iterable, orT> , provided by the IterableComparableExtension extensionnull
if the iterable is empty.no setter - maxOrNull → num?
-
Available on Iterable<
A maximal element of the iterable, ornum> , provided by the IterableNumberExtension extensionnull
if the iterable is empty.no setter - min → num
-
Available on Iterable<
A minimal element of the iterable.num> , provided by the IterableNumberExtension extensionno setter - min → double
-
Available on Iterable<
A minimal element of the iterable.double> , provided by the IterableDoubleExtension extensionno setter - min → int
-
Available on Iterable<
A minimal element of the iterable.int> , provided by the IterableIntegerExtension extensionno setter - min → T
-
Available on Iterable<
A minimal element of the iterable.T> , provided by the IterableComparableExtension extensionno setter - minOrNull → num?
-
Available on Iterable<
A minimal element of the iterable, ornum> , provided by the IterableNumberExtension extensionnull
it the iterable is empty.no setter - minOrNull → T?
-
Available on Iterable<
A minimal element of the iterable, orT> , provided by the IterableComparableExtension extensionnull
it the iterable is empty.no setter - minOrNull → int?
-
Available on Iterable<
A minimal element of the iterable, orint> , provided by the IterableIntegerExtension extensionnull
it the iterable is empty.no setter - minOrNull → double?
-
Available on Iterable<
A minimal element of the iterable, ordouble> , provided by the IterableDoubleExtension extensionnull
it the iterable is empty.no setter -
nonNulls
→ Iterable<
T> -
Available on Iterable<
The non-T?> , provided by the NullableIterableExtensions extensionnull
elements of this iterable.no setter -
reversed
→ Iterable<
E> -
An Iterable of the objects in this list in reverse order.
no setter
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- single → E
-
Checks that this iterable has only one element, and returns that element.
no setterinherited
- singleOrNull → T?
-
Available on Iterable<
The single element of this iterator, orT> , provided by the IterableExtensions extensionnull
.no setter - singleOrNull → T?
-
Available on Iterable<
The single element of the iterable, orT> , provided by the IterableExtension extensionnull
.no setter - sum → double
-
Available on Iterable<
The sum of the elements.double> , provided by the IterableDoubleExtension extensionno setter - sum → num
-
Available on Iterable<
The sum of the elements.num> , provided by the IterableNumberExtension extensionno setter - sum → int
-
Available on Iterable<
The sum of the elements.int> , provided by the IterableIntegerExtension extensionno setter -
toJS
→ JSArray<
T> -
Available on List<
Converts this List to a JSArray by either casting, unwrapping, or cloning the List.T> , provided by the ListToJSArray extensionno setter -
toJSProxyOrRef
→ JSArray<
T> -
Available on List<
Converts this List to a JSArray by either casting, unwrapping, or proxying the List.T> , provided by the ListToJSArray extensionno setter -
wait
→ Future<
List< T> > -
Available on Iterable<
Waits for futures in parallel.Future< , provided by the FutureIterable extensionT> >no setter
Methods
-
add(
E value) → void -
Adds
value
to the end of this list, extending the length by one. -
addAll(
Iterable< E> iterable) → void -
Appends all objects of
iterable
to the end of this list. -
any(
bool test(E element)) → bool -
Checks whether any element of this iterable satisfies
test
.inherited -
asMap(
) → Map< int, E> - An unmodifiable Map view of this list.
-
asNameMap(
) → Map< String, T> -
Available on Iterable<
Creates a map from the names of enum values to the values.T> , provided by the EnumByName extension -
binarySearch(
E element, int compare(E, E)) → int -
Available on List<
Returns the index ofE> , provided by the ListExtensions extensionelement
in this sorted list. -
binarySearch(
E element, [int compare(E, E)?]) → int -
Available on List<
Returns the index ofE> , provided by the ListComparableExtensions extensionelement
in this sorted list. -
binarySearchBy<
K extends Comparable< (K> >E element, K keyOf(E element), [int start = 0, int? end]) → int -
Available on List<
Returns the index ofE> , provided by the ListExtensions extensionelement
in this sorted list. -
binarySearchByCompare<
K> (E element, K keyOf(E element), int compare(K, K), [int start = 0, int? end]) → int -
Available on List<
Returns the index ofE> , provided by the ListExtensions extensionelement
in this sorted list. -
byName(
String name) → T -
Available on Iterable<
Finds the enum value in this list with nameT> , provided by the EnumByName extensionname
. -
cast<
R> () → List< R> -
Returns a view of this list as a list of
R
instances.override -
clear(
) → void - Removes all objects from this list; the length of the list becomes zero.
-
contains(
Object? element) → bool -
Whether the collection contains an element equal to
element
.inherited -
elementAt(
int index) → E -
Returns the
index
th element.inherited -
elementAtOrNull(
int index) → E? -
Available on List<
TheE> , provided by the ListExtensions extensionindex
th element, ornull
if there is no such element. -
elementAtOrNull(
int index) → T? -
Available on Iterable<
TheT> , provided by the IterableExtension extensionindex
th element, ornull
if there is no such element. -
elementAtOrNull(
int index) → T? -
Available on Iterable<
The element at positionT> , provided by the IterableExtensions extensionindex
of this iterable, ornull
. -
equals(
List< E> other, [Equality<E> equality = const DefaultEquality()]) → bool -
Available on List<
WhetherE> , provided by the ListExtensions extensionother
has the same elements as this list. -
every(
bool test(E element)) → bool -
Checks whether every element of this iterable satisfies
test
.inherited -
expand<
T> (Iterable< T> toElements(E element)) → Iterable<T> -
Expands each element of this Iterable into zero or more elements.
inherited
-
expandIndexed<
R> (Iterable< R> expand(int index, E element)) → Iterable<R> -
Available on List<
Expands each element and index to a number of elements in a new iterable.E> , provided by the ListExtensions extension -
expandIndexed<
R> (Iterable< R> expand(int index, T element)) → Iterable<R> -
Available on Iterable<
Expands each element and index to a number of elements in a new iterable.T> , provided by the IterableExtension extension -
fillRange(
int start, int end, [E? fillValue]) → void -
Overwrites a range of elements with
fillValue
. -
firstWhere(
bool test(E element), {E orElse()?}) → E -
The first element that satisfies the given predicate
test
.inherited -
firstWhereIndexedOrNull(
bool test(int index, T element)) → T? -
Available on Iterable<
The first element whose value and index satisfiesT> , provided by the IterableExtension extensiontest
. -
firstWhereOrNull(
bool test(T element)) → T? -
Available on Iterable<
The first element satisfyingT> , provided by the IterableExtension extensiontest
, ornull
if there are none. -
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
-
foldIndexed<
R> (R initialValue, R combine(int index, R previous, T element)) → R -
Available on Iterable<
Combine the elements with a value and the current index.T> , provided by the IterableExtension extension -
followedBy(
Iterable< E> other) → Iterable<E> -
Creates the lazy concatenation of this iterable and
other
.inherited -
forEach(
void action(E element)) → void -
Invokes
action
on each element of this iterable in iteration order.inherited -
forEachIndexed(
void action(int index, T element)) → void -
Available on Iterable<
Takes an action for each element.T> , provided by the IterableExtension extension -
forEachIndexed(
void action(int index, E element)) → void -
Available on List<
Takes an action for each element.E> , provided by the ListExtensions extension -
forEachIndexedWhile(
bool action(int index, E element)) → void -
Available on List<
Takes an action for each element and index as long as desired.E> , provided by the ListExtensions extension -
forEachIndexedWhile(
bool action(int index, T element)) → void -
Available on Iterable<
Takes an action for each element and index as long as desired.T> , provided by the IterableExtension extension -
forEachWhile(
bool action(T element)) → void -
Available on Iterable<
Takes an action for each element as long as desired.T> , provided by the IterableExtension extension -
forEachWhile(
bool action(E element)) → void -
Available on List<
Takes an action for each element as long as desired.E> , provided by the ListExtensions extension -
getRange(
int start, int end) → Iterable< E> - Creates an Iterable that iterates over a range of elements.
-
groupFoldBy<
K, G> (K keyOf(T element), G combine(G? previous, T element)) → Map< K, G> -
Available on Iterable<
Groups elements byT> , provided by the IterableExtension extensionkeyOf
then folds the elements in each group. -
groupListsBy<
K> (K keyOf(T element)) → Map< K, List< T> > -
Available on Iterable<
Groups elements into lists byT> , provided by the IterableExtension extensionkeyOf
. -
groupSetsBy<
K> (K keyOf(T element)) → Map< K, Set< T> > -
Available on Iterable<
Groups elements into sets byT> , provided by the IterableExtension extensionkeyOf
. -
indexOf(
E element, [int start = 0]) → int -
The first index of
element
in this list. -
indexWhere(
bool test(E element), [int start = 0]) → int -
The first index in the list that satisfies the provided
test
. -
insert(
int index, E element) → void -
Inserts
element
at positionindex
in this list. -
insertAll(
int index, Iterable< E> iterable) → void -
Inserts all objects of
iterable
at positionindex
in this list. -
isSorted(
[Comparator< T> ? compare]) → bool -
Available on Iterable<
Whether the elements are sorted by theT> , provided by the IterableComparableExtension extensioncompare
ordering. -
isSorted(
Comparator< T> compare) → bool -
Available on Iterable<
Whether the elements are sorted by theT> , provided by the IterableExtension extensioncompare
ordering. -
isSortedBy<
K extends Comparable< (K> >K keyOf(T element)) → bool -
Available on Iterable<
Whether the elements are sorted by theirT> , provided by the IterableExtension extensionkeyOf
property. -
isSortedByCompare<
K> (K keyOf(T element), Comparator< K> compare) → bool -
Available on Iterable<
Whether the elements areT> , provided by the IterableExtension extensioncompare
-sorted by theirkeyOf
property. -
join(
[String separator = ""]) → String -
Converts each element to a String and concatenates the strings.
inherited
-
lastBy<
K> (K key(T)) → Map< K, T> -
Available on Iterable<
Associates the elements inT> , provided by the IterableExtension extensionthis
by the value returned bykey
. -
lastIndexOf(
E element, [int? start]) → int -
The last index of
element
in this list. -
lastIndexWhere(
bool test(E element), [int? start]) → int -
The last index in the list that satisfies the provided
test
. -
lastWhere(
bool test(E element), {E orElse()?}) → E -
The last element that satisfies the given predicate
test
.inherited -
lastWhereIndexedOrNull(
bool test(int index, T element)) → T? -
Available on Iterable<
The last element whose index and value satisfiesT> , provided by the IterableExtension extensiontest
. -
lastWhereOrNull(
bool test(T element)) → T? -
Available on Iterable<
The last element satisfyingT> , provided by the IterableExtension extensiontest
, ornull
if there are none. -
lowerBound(
E element, [int compare(E, E)?]) → int -
Available on List<
Returns the index whereE> , provided by the ListComparableExtensions extensionelement
should be in this sorted list. -
lowerBound(
E element, int compare(E, E)) → int -
Available on List<
Returns the index whereE> , provided by the ListExtensions extensionelement
should be in this sorted list. -
lowerBoundBy<
K extends Comparable< (K> >E element, K keyOf(E), [int start = 0, int? end]) → int -
Available on List<
Returns the index whereE> , provided by the ListExtensions extensionelement
should be in this sorted list. -
lowerBoundByCompare<
K> (E element, K keyOf(E), int compare(K, K), [int start = 0, int? end]) → int -
Available on List<
Returns the index whereE> , provided by the ListExtensions extensionelement
should be in this sorted list. -
map<
T> (T toElement(E e)) → Iterable< T> -
The current elements of this iterable modified by
toElement
.inherited -
mapIndexed<
R> (R convert(int index, E element)) → Iterable< R> -
Available on List<
Maps each element and its index to a new value.E> , provided by the ListExtensions extension -
mapIndexed<
R> (R convert(int index, T element)) → Iterable< R> -
Available on Iterable<
Maps each element and its index to a new value.T> , provided by the IterableExtension extension -
none(
bool test(T)) → bool -
Available on Iterable<
Whether no element satisfiesT> , provided by the IterableExtension extensiontest
. -
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
-
reduceIndexed(
T combine(int index, T previous, T element)) → T -
Available on Iterable<
Combine the elements with each other and the current index.T> , provided by the IterableExtension extension -
remove(
Object? value) → bool -
Removes the first occurrence of
value
from this list. -
removeAt(
int index) → E -
Removes the object at position
index
from this list. -
removeLast(
) → E - Removes and returns the last object in this list.
-
removeRange(
int start, int end) → void - Removes a range of elements from the list.
-
removeWhere(
bool test(E element)) → void -
Removes all objects from this list that satisfy
test
. -
replaceRange(
int start, int end, Iterable< E> replacements) → void -
Replaces a range of elements with the elements of
replacements
. -
retainWhere(
bool test(E element)) → void -
Removes all objects from this list that fail to satisfy
test
. -
reverseRange(
int start, int end) → void -
Available on List<
Reverses the elements in a range of the list.E> , provided by the ListExtensions extension -
sample(
int count, [Random? random]) → List< T> -
Available on Iterable<
SelectsT> , provided by the IterableExtension extensioncount
elements at random from this iterable. -
setAll(
int index, Iterable< E> iterable) → void -
Overwrites elements with the objects of
iterable
. -
setRange(
int start, int end, Iterable< E> iterable, [int skipCount = 0]) → void -
Writes some elements of
iterable
into a range of this list. -
shuffle(
[Random? random]) → void - Shuffles the elements of this list randomly.
-
shuffled(
[Random? random]) → List< T> -
Available on Iterable<
Creates a shuffled list of the elements of the iterable.T> , provided by the IterableExtension extension -
shuffleRange(
int start, int end, [Random? random]) → void -
Available on List<
Shuffle a range of elements.E> , provided by the ListExtensions extension -
singleWhere(
bool test(E element), {E orElse()?}) → E -
The single element that satisfies
test
.inherited -
singleWhereIndexedOrNull(
bool test(int index, T element)) → T? -
Available on Iterable<
The single element satisfyingT> , provided by the IterableExtension extensiontest
. -
singleWhereOrNull(
bool test(T element)) → T? -
Available on Iterable<
The single element satisfyingT> , provided by the IterableExtension extensiontest
. -
skip(
int count) → Iterable< E> -
Creates an Iterable that provides all but the first
count
elements.inherited -
skipWhile(
bool test(E value)) → Iterable< E> -
Creates an
Iterable
that skips leading elements whiletest
is satisfied.inherited -
slice(
int start, [int? end]) → ListSlice< E> -
Available on List<
A fixed length view of a range of this list.E> , provided by the ListExtensions extension -
slices(
int length) → Iterable< List< E> > -
Available on List<
Contiguous slices ofE> , provided by the ListExtensions extensionthis
with the givenlength
. -
slices(
int length) → Iterable< List< T> > -
Available on Iterable<
Contiguous slices ofT> , provided by the IterableExtension extensionthis
with the givenlength
. -
sort(
[int compare(E a, E b)?]) → void -
Sorts this list according to the order specified by the
compare
function. -
sortBy<
K extends Comparable< (K> >K keyOf(E element), [int start = 0, int? end]) → void -
Available on List<
Sorts elements by the natural order of theirE> , provided by the ListExtensions extensionkeyOf
property. -
sortByCompare<
K> (K keyOf(E element), int compare(K a, K b), [int start = 0, int? end]) → void -
Available on List<
Sorts elements by theE> , provided by the ListExtensions extensioncompare
of theirkeyOf
property. -
sorted(
Comparator< T> compare) → List<T> -
Available on Iterable<
Creates a sorted list of the elements of the iterable.T> , provided by the IterableExtension extension -
sorted(
[Comparator< T> ? compare]) → List<T> -
Available on Iterable<
Creates a sorted list of the elements of the iterable.T> , provided by the IterableComparableExtension extension -
sortedBy<
K extends Comparable< (K> >K keyOf(T element)) → List< T> -
Available on Iterable<
Creates a sorted list of the elements of the iterable.T> , provided by the IterableExtension extension -
sortedByCompare<
K> (K keyOf(T element), Comparator< K> compare) → List<T> -
Available on Iterable<
Creates a sorted list of the elements of the iterable.T> , provided by the IterableExtension extension -
sortRange(
int start, int end, int compare(E a, E b)) → void -
Available on List<
Sort a range of elements byE> , provided by the ListExtensions extensioncompare
. -
sortRange(
int start, int end, [int compare(E a, E b)?]) → void -
Available on List<
Sort a range of elements byE> , provided by the ListComparableExtensions extensioncompare
. -
splitAfter(
bool test(T element)) → Iterable< List< T> > -
Available on Iterable<
Splits the elements into chunks after some elements.T> , provided by the IterableExtension extension -
splitAfterIndexed(
bool test(int index, T element)) → Iterable< List< T> > -
Available on Iterable<
Splits the elements into chunks after some elements and indices.T> , provided by the IterableExtension extension -
splitBefore(
bool test(T element)) → Iterable< List< T> > -
Available on Iterable<
Splits the elements into chunks before some elements.T> , provided by the IterableExtension extension -
splitBeforeIndexed(
bool test(int index, T element)) → Iterable< List< T> > -
Available on Iterable<
Splits the elements into chunks before some elements and indices.T> , provided by the IterableExtension extension -
splitBetween(
bool test(T first, T second)) → Iterable< List< T> > -
Available on Iterable<
Splits the elements into chunks between some elements.T> , provided by the IterableExtension extension -
splitBetweenIndexed(
bool test(int index, T first, T second)) → Iterable< List< T> > -
Available on Iterable<
Splits the elements into chunks between some elements and indices.T> , provided by the IterableExtension extension -
sublist(
int start, [int? end]) → List< E> -
Returns a new list containing the elements between
start
andend
. -
swap(
int index1, int index2) → void -
Available on List<
Swaps two elements of this list.E> , provided by the ListExtensions extension -
take(
int count) → Iterable< E> -
Creates a lazy iterable of the
count
first elements of this iterable.inherited -
takeWhile(
bool test(E value)) → 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 element)) → Iterable< E> -
Creates a new lazy Iterable with all elements that satisfy the
predicate
test
.inherited -
whereIndexed(
bool test(int index, T element)) → Iterable< T> -
Available on Iterable<
The elements whose value and index satisfiesT> , provided by the IterableExtension extensiontest
. -
whereIndexed(
bool test(int index, E element)) → Iterable< E> -
Available on List<
The elements whose value and index satisfiesE> , provided by the ListExtensions extensiontest
. -
whereNot(
bool test(T element)) → Iterable< T> -
Available on Iterable<
The elements that do not satisfyT> , provided by the IterableExtension extensiontest
. -
whereNotIndexed(
bool test(int index, T element)) → Iterable< T> -
Available on Iterable<
The elements whose value and index do not satisfyT> , provided by the IterableExtension extensiontest
. -
whereNotIndexed(
bool test(int index, E element)) → Iterable< E> -
Available on List<
The elements whose value and index do not satisfyE> , provided by the ListExtensions extensiontest
. -
whereNotNull(
) → Iterable< T> -
Available on Iterable<
The non-T?> , provided by the IterableNullableExtension extensionnull
elements of thisIterable
. -
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
. -
operator ==(
Object other) → bool -
Whether this list is equal to
other
.override -
operator [](
int index) → E -
The object at the given
index
in the list. -
operator []=(
int index, E value) → void -
Sets the value at the given
index
in the list tovalue
.
Static Methods
-
castFrom<
S, T> (List< S> source) → List<T> -
Adapts
source
to be aList<T>
.override -
copyRange<
T> (List< T> target, int at, List<T> source, [int? start, int? end]) → void - Copy a range of one list into another list.
-
writeIterable<
T> (List< T> target, int at, Iterable<T> source) → void - Write the elements of an iterable into a list.