dart:collection
UnmodifiableListView<E> class
An unmodifiable List view of another List.
The source of the elements may be a List or any Iterable with efficient Iterable.length and Iterable.elementAt.
final numbers = <int>[10, 20, 30];
final unmodifiableListView = UnmodifiableListView(numbers);
// Insert new elements into the original list.
numbers.addAll([40, 50]);
print(unmodifiableListView); // [10, 20, 30, 40, 50]
unmodifiableListView.remove(20); // Throws.
- Inheritance
-
- Available Extensions
Constructors
- UnmodifiableListView(Iterable<E> source)
- Creates an unmodifiable list backed by
source.
Properties
- first ↔ E
read / write, inherited
- Returns the first element.
- hashCode → int
read-only, inherited
- The hash code for this object.
- isEmpty → bool
read-only, inherited
- Whether this collection has no elements.
- isNotEmpty → bool
read-only, inherited
- Whether this collection has at least one element.
- iterator → Iterator<E>
read-only, inherited
- Returns a new
Iterator that allows iterating the elements of this Iterable. - last ↔ E
read / write, inherited
- Returns the last element.
- length ↔ int
read / write, inherited-setter, override-getter
- The number of objects in this list.
- reversed → Iterable<E>
read-only, inherited
- An Iterable of the objects in this list in reverse order.
- runtimeType → Type
read-only, inherited
- A representation of the runtime type of the object.
- single → E
read-only, inherited
- Checks that this iterable has only one element, and returns that element.
Methods
- add(E value) → void
inherited
- This operation is not supported by an unmodifiable list.
- addAll(Iterable<E> iterable) → void
inherited
- This operation is not supported by an unmodifiable list.
- any(bool test(E element)) → bool
inherited
- Checks whether any element of this iterable satisfies
test. - asMap() → Map<int, E>
inherited
- An unmodifiable Map view of this list.
- cast<R>() → List<R>
override
- Returns a view of this list as a list of
R instances. - clear() → void
inherited
- This operation is not supported by an unmodifiable list.
- contains(Object? element) → bool
inherited
- Whether the collection contains an element equal to
element. - elementAt(int index) → E
inherited
- Returns the
indexth element. - every(bool test(E element)) → bool
inherited
- Checks whether every element of this iterable satisfies
test. - expand<T>(Iterable<T> f(E element)) → Iterable<T>
inherited
- Expands each element of this Iterable into zero or more elements.
- fillRange(int start, int end, [E? fillValue]) → void
inherited
- This operation is not supported by an unmodifiable list.
- firstWhere(bool test(E element), {E orElse()?}) → E
inherited
- Returns the first element that satisfies the given predicate
test. - fold<T>(T initialValue, T combine(T previousValue, E element)) → T
inherited
- Reduces a collection to a single value by iteratively combining each element of the collection with an existing value
- followedBy(Iterable<E> other) → Iterable<E>
inherited
- Returns the lazy concatenation of this iterable and
other. - forEach(void action(E element)) → void
inherited
- Invokes
action on each element of this iterable in iteration order. - getRange(int start, int end) → Iterable<E>
inherited
- Creates an Iterable that iterates over a range of elements.
- indexOf(Object? element, [int start = 0]) → int
inherited
- The first index of
element in this list. - indexWhere(bool test(E element), [int start = 0]) → int
inherited
- The first index in the list that satisfies the provided
test. - insert(int index, E element) → void
inherited
- This operation is not supported by an unmodifiable list.
- insertAll(int at, Iterable<E> iterable) → void
inherited
- This operation is not supported by an unmodifiable list.
- join([String separator = ""]) → String
inherited
- Converts each element to a String and concatenates the strings.
- lastIndexOf(Object? element, [int? start]) → int
inherited
- The last index of
element in this list. - lastIndexWhere(bool test(E element), [int? start]) → int
inherited
- The last index in the list that satisfies the provided
test. - lastWhere(bool test(E element), {E orElse()?}) → E
inherited
- Returns the last element that satisfies the given predicate
test. - map<T>(T f(E element)) → Iterable<T>
inherited
- The current elements of this iterable modified by
toElement. - noSuchMethod(Invocation invocation) → dynamic
inherited
- Invoked when a non-existent method or property is accessed.
- reduce(E combine(E previousValue, E element)) → E
inherited
- Reduces a collection to a single value by iteratively combining elements of the collection using the provided function.
- remove(Object? element) → bool
inherited
- This operation is not supported by an unmodifiable list.
- removeAt(int index) → E
inherited
- This operation is not supported by an unmodifiable list.
- removeLast() → E
inherited
- This operation is not supported by an unmodifiable list.
- removeRange(int start, int end) → void
inherited
- This operation is not supported by an unmodifiable list.
- removeWhere(bool test(E element)) → void
inherited
- This operation is not supported by an unmodifiable list.
- replaceRange(int start, int end, Iterable<E> iterable) → void
inherited
- This operation is not supported by an unmodifiable list.
- retainWhere(bool test(E element)) → void
inherited
- This operation is not supported by an unmodifiable list.
- setAll(int at, Iterable<E> iterable) → void
inherited
- This operation is not supported by an unmodifiable list.
- setRange(int start, int end, Iterable<E> iterable, [int skipCount = 0]) → void
inherited
- This operation is not supported by an unmodifiable list.
- shuffle([Random? random]) → void
inherited
- This operation is not supported by an unmodifiable list.
- singleWhere(bool test(E element), {E orElse()?}) → E
inherited
- Returns the single element that satisfies
test. - skip(int count) → Iterable<E>
inherited
- Returns an Iterable that provides all but the first
count elements. - skipWhile(bool test(E element)) → Iterable<E>
inherited
- Returns an
Iterable that skips leading elements while test is satisfied. - sort([Comparator<E>? compare]) → void
inherited
- This operation is not supported by an unmodifiable list.
- sublist(int start, [int? end]) → List<E>
inherited
- Returns a new list containing the elements between
start and end. - take(int count) → Iterable<E>
inherited
- Returns a lazy iterable of the
count first elements of this iterable. - takeWhile(bool test(E element)) → Iterable<E>
inherited
- Returns a lazy iterable of the leading elements satisfying
test. - toList({bool growable = true}) → List<E>
inherited
- Creates a List containing the elements of this Iterable.
- toSet() → Set<E>
inherited
- Creates a Set containing the same elements as this iterable.
- toString() → String
inherited
- A string representation of this object.
- where(bool test(E element)) → Iterable<E>
inherited
- Returns a new lazy Iterable with all elements that satisfy the predicate
test. - whereType<T>() → Iterable<T>
inherited
- Returns a new lazy Iterable with all elements that have type
T.
Operators
- operator +(List<E> other) → List<E>
inherited
- Returns the concatenation of this list and
other. - operator ==(Object other) → bool
inherited
- The equality operator.
- operator [](int index) → E
override
- The object at the given
index in the list. - operator []=(int index, E value) → void
inherited
- This operation is not supported by an unmodifiable list.