description

# Uint8ClampedList class Null safety

A fixed-length list of 8-bit unsigned integers.

For long lists, this implementation can be considerably more space- and time-efficient than the default List implementation.

Integers stored in the list are clamped to an unsigned eight bit value. That is, all values below zero are stored as zero and all values above 255 are stored as 255.

Implemented types
  - List<int>
Implementers
  - UnmodifiableUint8ClampedListView

## Constructors

Uint8ClampedList(int length)
  Creates a Uint8ClampedList of the specified length (in elements), all of whose elements are initially zero. [...]
  factory
Uint8ClampedList.fromList(List<int> elements)
  Creates a Uint8ClampedList of the same size as the `elements` list and copies over the values clamping when needed. [...]
  factory
Uint8ClampedList.sublistView(TypedData data, [int start = 0, int? end])
  Creates a Uint8ClampedList view on a range of elements of `data`. [...]
  factory
Uint8ClampedList.view(ByteBuffer buffer, [int offsetInBytes = 0, int? length])
  Creates a Uint8ClampedList view of the specified region in the specified byte `buffer`. [...]
  factory

## Properties

buffer → ByteBuffer
  Returns the byte buffer associated with this object.
  read-only, inherited
elementSizeInBytes → int
  Returns the number of bytes in the representation of each element in this list.
  read-only, inherited
first ↔ int
  Returns the first element. [...]
  read / write, inherited
hashCode → int
  The hash code for this object. [...]
  read-only, inherited
isEmpty → bool
  Returns `true` if there are no elements in this collection. [...]
  read-only, inherited
isNotEmpty → bool
  Returns true if there is at least one element in this collection. [...]
  read-only, inherited
iterator → Iterator<int>
  Returns a new `Iterator` that allows iterating the elements of this `Iterable`. [...]
  read-only, inherited
last ↔ int
  Returns the last element. [...]
  read / write, inherited
length ↔ int
  The number of objects in this list. [...]
  read / write, inherited
lengthInBytes → int
  Returns the length of this view, in bytes.
  read-only, inherited
offsetInBytes → int
  Returns the offset in bytes into the underlying byte buffer of this view.
  read-only, inherited
reversed → Iterable<int>
  Returns an Iterable of the objects in this list in reverse order.
  read-only, inherited
runtimeType → Type
  A representation of the runtime type of the object.
  read-only, inherited
single → int
  Checks that this iterable has only one element, and returns that element. [...]
  read-only, inherited

## Methods

add(int value) → void
  Adds `value` to the end of this list, extending the length by one. [...]
  inherited
addAll(Iterable<int> iterable) → void
  Appends all objects of `iterable` to the end of this list. [...]
  inherited
any(bool test(int element)) → bool
  Checks whether any element of this iterable satisfies `test`. [...]
  inherited
asMap() → Map<int, int>
  Returns an unmodifiable Map view of `this`. [...]
  inherited
cast<R>() → List<R>
  Returns a view of this list as a list of `R` instances. [...]
  inherited
clear() → void
  Removes all objects from this list; the length of the list becomes zero. [...]
  inherited
contains(Object? element) → bool
  Returns true if the collection contains an element equal to `element`. [...]
  inherited
elementAt(int index) → int
  Returns the `index`th element. [...]
  inherited
every(bool test(int element)) → bool
  Checks whether every element of this iterable satisfies `test`. [...]
  inherited
expand<T>(Iterable<T> f(int element)) → Iterable<T>
  Expands each element of this Iterable into zero or more elements. [...]
  inherited
fillRange(int start, int end, [int? fillValue]) → void
  Sets the objects in the range `start` inclusive to `end` exclusive to the given `fillValue`. [...]
  inherited
firstWhere(bool test(int element), {int orElse()}) → int
  Returns the first element that satisfies the given predicate `test`. [...]
  inherited
fold<T>(T initialValue, T combine(T previousValue, int element)) → T
  Reduces a collection to a single value by iteratively combining each element of the collection with an existing value [...]
  inherited
followedBy(Iterable<int> other) → Iterable<int>
  Returns the lazy concatentation of this iterable and `other`. [...]
  inherited
forEach(void f(int element)) → void
  Applies the function `f` to each element of this collection in iteration order.
  inherited
getRange(int start, int end) → Iterable<int>
  Returns an Iterable that iterates over the objects in the range `start` inclusive to `end` exclusive. [...]
  inherited
indexOf(int element, [int start = 0]) → int
  Returns the first index of `element` in this list. [...]
  inherited
indexWhere(bool test(int element), [int start = 0]) → int
  Returns the first index in the list that satisfies the provided `test`. [...]
  inherited
insert(int index, int element) → void
  Inserts the object at position `index` in this list. [...]
  inherited
insertAll(int index, Iterable<int> iterable) → void
  Inserts all objects of `iterable` at position `index` in this list. [...]
  inherited
join([String separator = ""]) → String
  Converts each element to a String and concatenates the strings. [...]
  inherited
lastIndexOf(int element, [int? start]) → int
  Returns the last index of `element` in this list. [...]
  inherited
lastIndexWhere(bool test(int element), [int? start]) → int
  Returns the last index in the list that satisfies the provided `test`. [...]
  inherited
lastWhere(bool test(int element), {int orElse()}) → int
  Returns the last element that satisfies the given predicate `test`. [...]
  inherited
map<T>(T f(int 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. [...]
  inherited
noSuchMethod(Invocation invocation) → dynamic
  Invoked when a non-existent method or property is accessed. [...]
  inherited
reduce(int combine(int value, int element)) → int
  Reduces a collection to a single value by iteratively combining elements of the collection using the provided function. [...]
  inherited
remove(Object? value) → bool
  Removes the first occurrence of `value` from this list. [...]
  inherited
removeAt(int index) → int
  Removes the object at position `index` from this list. [...]
  inherited
removeLast() → int
  Pops and returns the last object in this list. [...]
  inherited
removeRange(int start, int end) → void
  Removes the objects in the range `start` inclusive to `end` exclusive. [...]
  inherited
removeWhere(bool test(int element)) → void
  Removes all objects from this list that satisfy `test`. [...]
  inherited
replaceRange(int start, int end, Iterable<int> replacement) → void
  Removes the objects in the range `start` inclusive to `end` exclusive and inserts the contents of `replacement` in its place. [...]
  inherited
retainWhere(bool test(int element)) → void
  Removes all objects from this list that fail to satisfy `test`. [...]
  inherited
setAll(int index, Iterable<int> iterable) → void
  Overwrites objects of `this` with the objects of `iterable`, starting at position `index` in this list. [...]
  inherited
setRange(int start, int end, Iterable<int> iterable, [int skipCount = 0]) → void
  Copies the objects of `iterable`, skipping `skipCount` objects first, into the range `start`, inclusive, to `end`, exclusive, of the list. [...]
  inherited
shuffle([Random? random]) → void
  Shuffles the elements of this list randomly.
  inherited
singleWhere(bool test(int element), {int orElse()}) → int
  Returns the single element that satisfies `test`. [...]
  inherited
skip(int count) → Iterable<int>
  Returns an Iterable that provides all but the first `count` elements. [...]
  inherited
skipWhile(bool test(int value)) → Iterable<int>
  Returns an `Iterable` that skips leading elements while `test` is satisfied. [...]
  inherited
sort([int compare(int a, int b)]) → void
  Sorts this list according to the order specified by the `compare` function. [...]
  inherited
sublist(int start, [int? end]) → Uint8ClampedList
  Returns a new list containing the elements between `start` and `end`. [...]
  override
take(int count) → Iterable<int>
  Returns a lazy iterable of the `count` first elements of this iterable. [...]
  inherited
takeWhile(bool test(int value)) → Iterable<int>
  Returns a lazy iterable of the leading elements satisfying `test`. [...]
  inherited
toList({bool growable: true}) → List<int>
  Creates a List containing the elements of this Iterable. [...]
  inherited
toSet() → Set<int>
  Creates a Set containing the same elements as this iterable. [...]
  inherited
toString() → String
  Returns a string representation of this object.
  inherited
where(bool test(int element)) → Iterable<int>
  Returns a new lazy Iterable with all elements that satisfy the predicate `test`. [...]
  inherited
whereType<T>() → Iterable<T>
  Returns a new lazy Iterable with all elements that have type `T`. [...]
  inherited

## Operators

operator +(List<int> other) → List<int>
  Returns the concatenation of this list and `other`. [...]
  inherited
operator ==(Object other) → bool
  The equality operator. [...]
  inherited
operator [](int index) → int
  Returns the object at the given `index` in the list or throws a RangeError if `index` is out of bounds.
  inherited
operator []=(int index, int value) → void
  Sets the value at the given `index` in the list to `value` or throws a RangeError if `index` is out of bounds.
  inherited

## Constants

bytesPerElement → const int
  `1`