UnmodifiableListView class - dart:collection library (original) (raw)

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

Implemented types

Available extensions

Constructors

UnmodifiableListView(Iterable<E> source)

Creates an unmodifiable list backed by source.

Properties

first ↔ E

The first element.

getter/setter pairinherited

firstOrNull → T?

Available on Iterable<T>, provided by the IterableExtensions extension

The first element of this iterator, or null if the iterable is empty.

no setter

hashCodeint

The hash code for this object.

no setterinherited

indexedIterable<(int, T)>

Available on Iterable<T>, provided by the IterableExtensions extension

Pairs of elements of the indices and elements of this iterable.

no setter

isEmptybool

Whether this collection has no elements.

no setterinherited

isNotEmptybool

Whether this collection has at least one element.

no setterinherited

iteratorIterator<E>

A new Iterator that allows iterating the elements of this Iterable.

no setterinherited

last ↔ E

The last element.

getter/setter pairinherited

lastOrNull → T?

Available on Iterable<T>, provided by the IterableExtensions extension

The last element of this iterable, or null if the iterable is empty.

no setter

lengthint

The number of objects in this list.

getter/setter pairinherited-setteroverride-getter

nonNullsIterable<T>

Available on Iterable<T?>, provided by the NullableIterableExtensions extension

The non-null elements of this iterable.

no setter

reversedIterable<E>

An Iterable of the objects in this list in reverse order.

no setterinherited

runtimeTypeType

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<T>, provided by the IterableExtensions extension

The single element of this iterator, or null.

no setter

toJSJSArray<T>

Available on List<T>, provided by the ListToJSArray extension

Converts this List to a JSArray by either casting, unwrapping, or cloning the List.

no setter

toJSProxyOrRefJSArray<T>

Available on List<T>, provided by the ListToJSArray extension

Converts this List to a JSArray by either casting, unwrapping, or proxying the List.

no setter

waitFuture<List<T>>

Available on Iterable<Future<T>>, provided by the FutureIterable extension

Waits for futures in parallel.

no setter

Methods

add(E value)→ void

This operation is not supported by an unmodifiable list.

inherited

addAll(Iterable<E> iterable)→ void

This operation is not supported by an unmodifiable list.

inherited

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.

inherited

asNameMap()→ Map<String, T>

Available on Iterable<T>, provided by the EnumByName extension

Creates a map from the names of enum values to the values.

byName(String name)→ T

Available on Iterable<T>, provided by the EnumByName extension

Finds the enum value in this list with name name.

cast<R>()→ List<R>

Returns a view of this list as a list of R instances.

override

clear()→ void

This operation is not supported by an unmodifiable list.

inherited

contains(Object? element)→ bool

Whether the collection contains an element equal to element.

inherited

elementAt(int index)→ E

Returns the indexth element.

inherited

elementAtOrNull(int index)→ T?

Available on Iterable<T>, provided by the IterableExtensions extension

The element at position index of this iterable, or null.

every(bool test(E element))→ bool

Checks whether every element of this iterable satisfies test.

inherited

expand<T>(Iterable<T> f(E element))→ Iterable<T>

Expands each element of this Iterable into zero or more elements.

inherited

fillRange(int start, int end, [E? fillValue])→ void

This operation is not supported by an unmodifiable list.

inherited

firstWhere(bool test(E element), {E orElse()?})→ E

The first element that satisfies the given predicate test.

inherited

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

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

getRange(int start, int end)→ Iterable<E>

Creates an Iterable that iterates over a range of elements.

inherited

indexOf(Object? element, [int start = 0])→ int

The first index of element in this list.

inherited

indexWhere(bool test(E element), [int start = 0])→ int

The first index in the list that satisfies the provided test.

inherited

insert(int index, E element)→ void

This operation is not supported by an unmodifiable list.

inherited

insertAll(int at, Iterable<E> iterable)→ void

This operation is not supported by an unmodifiable list.

inherited

join([String separator = ""])→ String

Converts each element to a String and concatenates the strings.

inherited

lastIndexOf(Object? element, [int? start])→ int

The last index of element in this list.

inherited

lastIndexWhere(bool test(E element), [int? start])→ int

The last index in the list that satisfies the provided test.

inherited

lastWhere(bool test(E element), {E orElse()?})→ E

The last element that satisfies the given predicate test.

inherited

map<T>(T f(E element))→ Iterable<T>

The current elements of this iterable modified by toElement.

inherited

noSuchMethod(Invocation invocation)→ dynamic

Invoked when a nonexistent 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.

inherited

remove(Object? element)→ bool

This operation is not supported by an unmodifiable list.

inherited

removeAt(int index)→ E

This operation is not supported by an unmodifiable list.

inherited

removeLast()→ E

This operation is not supported by an unmodifiable list.

inherited

removeRange(int start, int end)→ void

This operation is not supported by an unmodifiable list.

inherited

removeWhere(bool test(E element))→ void

This operation is not supported by an unmodifiable list.

inherited

replaceRange(int start, int end, Iterable<E> iterable)→ void

This operation is not supported by an unmodifiable list.

inherited

retainWhere(bool test(E element))→ void

This operation is not supported by an unmodifiable list.

inherited

setAll(int at, Iterable<E> iterable)→ void

This operation is not supported by an unmodifiable list.

inherited

setRange(int start, int end, Iterable<E> iterable, [int skipCount = 0])→ void

This operation is not supported by an unmodifiable list.

inherited

shuffle([Random? random])→ void

This operation is not supported by an unmodifiable list.

inherited

singleWhere(bool test(E element), {E orElse()?})→ E

The single element that satisfies test.

inherited

skip(int count)→ Iterable<E>

Creates an Iterable that provides all but the first count elements.

inherited

skipWhile(bool test(E element))→ Iterable<E>

Creates an Iterable that skips leading elements while test is satisfied.

inherited

sort([Comparator<E>? compare])→ void

This operation is not supported by an unmodifiable list.

inherited

sublist(int start, [int? end])→ List<E>

Returns a new list containing the elements between start and end.

inherited

take(int count)→ Iterable<E>

Creates a lazy iterable of the count first elements of this iterable.

inherited

takeWhile(bool test(E element))→ 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

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.

inherited

operator ==(Object other)→ bool

The equality operator.

inherited

operator [](int index)→ E

The object at the given index in the list.

override

operator []=(int index, E value)→ void

This operation is not supported by an unmodifiable list.

inherited