NonGrowableListView<E> class

A fixed-length list.

A NonGrowableListView contains a List object and ensures that its length does not change. Methods that would change the length of the list, such as add and remove, throw an UnsupportedError. All other methods work directly on the underlying list.

This class does allow changes to the contents of the wrapped list. You can, for example, sort the list. Permitted operations defer to the wrapped list.

Inheritance

• Object
• DelegatingList<E>
• NonGrowableListView

Implemented types

• Iterable<E>

Mixed-in types

• NonGrowableListMixin<E>

Available extensions

• EnumByName
• FutureIterable
• IterableComparableExtension
• IterableDoubleExtension
• IterableExtension
• IterableExtensions
• IterableIntegerExtension
• IterableIterableExtension
• IterableNullableExtension
• IterableNumberExtension
• IterableX
• ListComparableExtensions
• ListExtensions
• ListToJSArray
• ListX
• NullableIterableExtensions

Constructors

NonGrowableListView(List<E> listBase)

Properties

first ↔ E

The first element.

getter/setter pair, inherited

hashCode → int

The hash code for this object.

no setter, inherited

isEmpty → bool

Whether this collection has no elements.

no setter, inherited

isNotEmpty → bool

Whether this collection has at least one element.

no setter, inherited

iterator → Iterator<E>

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

no setter, inherited

last ↔ E

The last element.

getter/setter pair, inherited

length ↔ int

The number of elements in this Iterable.

getter/setter pair, inherited

reversed → Iterable<E>

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

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

single → E

Checks that this iterable has only one element, and returns that element.

no setter, inherited

Methods

add(E value) → bool

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

addAll(Iterable<E> iterable) → void

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

any(bool test(E)) → bool

Checks whether any element of this iterable satisfies test.

inherited

asMap() → Map<int, E>

An unmodifiable Map view of this list.

inherited

cast<T>() → List<T>

A view of this iterable as an iterable of R instances.

inherited

clear() → void

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

contains(Object? element) → bool

Whether the collection contains an element equal to element.

inherited

elementAt(int index) → E

Returns the indexth element.

inherited

every(bool test(E)) → bool

Checks whether every element of this iterable satisfies test.

inherited

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

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

inherited

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

Overwrites a range of elements with fillValue.

inherited

firstWhere(bool test(E), {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 f(E)) → 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(E element, [int start = 0]) → int

The first index of element in this list.

inherited

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

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

inherited

insert(int index, E element) → void

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

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

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

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

Converts each element to a String and concatenates the strings.

inherited

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

The last index of element in this list.

inherited

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

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

inherited

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

The last element that satisfies the given predicate test.

inherited

map<T>(T f(E)) → 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 value, E element)) → E

Reduces a collection to a single value by iteratively combining elements of the collection using the provided function.

inherited

remove(Object? value) → bool

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

removeAt(int index) → E

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

removeLast() → E

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

removeRange(int start, int end) → void

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

removeWhere(bool test(E)) → void

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

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

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

retainWhere(bool test(E)) → void

Throws an UnsupportedError; operations that change the length of the list are disallowed.

inherited

retype<T>() → List<T>

inherited

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

Overwrites elements with the objects of iterable.

inherited

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

Writes some elements of iterable into a range of this list.

inherited

shuffle([Random? random]) → void

Shuffles the elements of this list randomly.

inherited

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

The single element that satisfies test.

inherited

skip(int n) → Iterable<E>

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

inherited

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

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

inherited

sort([int compare(E, E)?]) → void

Sorts this list according to the order specified by the compare function.

inherited

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

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

inherited

take(int n) → Iterable<E>

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

inherited

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

inherited

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

Sets the value at the given index in the list to value.

inherited