BuiltList<E> class Null safety

The Built Collection List.

It implements Iterable and the non-mutating part of the List interface. Modifications are made via ListBuilder.

See the Built Collection library documentation (#built_collection/built_collection) for the general properties of Built Collections.

Implemented types
Available Extensions

Constructors

BuiltList([Iterable iterable = const []])
Instantiates with elements from an Iterable. [...]
factory
BuiltList.build(dynamic updates(ListBuilder<E>))
Creates a ListBuilder, applies updates to it, and builds.
factory
BuiltList.from(Iterable iterable)
Instantiates with elements from an Iterable. [...]
factory
BuiltList.of(Iterable<E> iterable)
Instantiates with elements from an Iterable<E>. [...]
factory

Properties

first → E
Returns the first element. [...]
read-only, override
hashCode int
Deep hashCode. [...]
read-only, override
isEmpty bool
Returns true if there are no elements in this collection. [...]
read-only, override
isNotEmpty bool
Returns true if there is at least one element in this collection. [...]
read-only, override
iterator Iterator<E>
Returns a new Iterator that allows iterating the elements of this Iterable. [...]
read-only, override
last → E
Returns the last element. [...]
read-only, override
length int
As List.length.
read-only, override
reversed Iterable<E>
As List.reversed.
read-only
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited
single → E
Checks that this iterable has only one element, and returns that element. [...]
read-only, override

Methods

any(bool test(E)) bool
Checks whether any element of this iterable satisfies test. [...]
override
asList() List<E>
Returns as an immutable list. [...]
asMap() Map<int, E>
As List.asMap.
cast<T>() Iterable<T>
Provides a view of this iterable as an iterable of R instances. [...]
override
contains(Object? element) bool
Whether the collection contains an element equal to element. [...]
override
elementAt(int index) → E
Returns the indexth element. [...]
override
every(bool test(E)) bool
Checks whether every element of this iterable satisfies test. [...]
override
expand<T>(Iterable<T> f(E)) Iterable<T>
Expands each element of this Iterable into zero or more elements. [...]
override
firstWhere(bool test(E), {E orElse()?}) → E
Returns the first element that satisfies the given predicate test. [...]
override
fold<T>(T initialValue, T combine(T, E)) → T
Reduces a collection to a single value by iteratively combining each element of the collection with an existing value [...]
override
followedBy(Iterable<E> other) Iterable<E>
Returns the lazy concatenation of this iterable and other. [...]
override
forEach(void f(E)) → void
Applies the function f to each element of this collection in iteration order.
override
getRange(int start, int end) Iterable<E>
As List.getRange.
indexOf(E element, [int start = 0]) int
As List.indexOf.
indexWhere(bool test(E), [int start = 0]) int
As List.indexWhere.
join([String separator = '']) String
Converts each element to a String and concatenates the strings. [...]
override
lastIndexOf(E element, [int? start]) int
As List.lastIndexOf.
lastIndexWhere(bool test(E), [int? start]) int
As List.lastIndexWhere.
lastWhere(bool test(E), {E orElse()?}) → E
Returns the last element that satisfies the given predicate test. [...]
override
map<T>(T f(E)) Iterable<T>
Returns a new lazy Iterable with elements that are created by calling f on each element of this Iterable in iteration order. [...]
override
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed. [...]
inherited
rebuild(dynamic updates(ListBuilder<E>)) BuiltList<E>
Converts to a ListBuilder, applies updates to it, and builds.
reduce(E combine(E, E)) → E
Reduces a collection to a single value by iteratively combining elements of the collection using the provided function. [...]
override
singleWhere(bool test(E), {E orElse()?}) → E
Returns the single element that satisfies test. [...]
override
skip(int n) Iterable<E>
Returns an Iterable that provides all but the first count elements. [...]
override
skipWhile(bool test(E)) Iterable<E>
Returns an Iterable that skips leading elements while test is satisfied. [...]
override
sublist(int start, [int? end]) BuiltList<E>
As List.sublist but returns a BuiltList<E>.
take(int n) Iterable<E>
Returns a lazy iterable of the count first elements of this iterable. [...]
override
takeWhile(bool test(E)) Iterable<E>
Returns a lazy iterable of the leading elements satisfying test. [...]
override
toBuilder() ListBuilder<E>
Converts to a ListBuilder for modification. [...]
toBuiltList() BuiltList<E>
Converts to a BuiltList.
toBuiltSet() BuiltSet<E>
Converts to a BuiltSet.
toList({bool growable = true}) List<E>
As Iterable.toList. [...]
override
toSet() Set<E>
Creates a Set containing the same elements as this iterable. [...]
override
toString() String
A string representation of this object. [...]
override
where(bool test(E)) Iterable<E>
Returns a new lazy Iterable with all elements that satisfy the predicate test. [...]
override
whereType<T>() Iterable<T>
Returns a new lazy Iterable with all elements that have type T. [...]
override

Operators

operator +(BuiltList<E> other) BuiltList<E>
As List.+.
operator ==(Object other) bool
Deep equality. [...]
override
operator [](int index) → E
As List.elementAt.