description

# Uint8ClampedList class abstract final

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.

It is a compile-time error for a class to attempt to extend or implement `Uint8ClampedList`.

Implemented types
  - TypedDataList<int>
Available extensions
  - Uint8ClampedListToJSUint8ClampedArray

## 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
  The byte buffer associated with this object.
  no setterinherited
elementSizeInBytes → int
  The number of bytes in the representation of each element in this list.
  no setterinherited
first ↔ int
  The first element.
  getter/setter pairinherited
hashCode → int
  The hash code for this object.
  no setterinherited
isEmpty → bool
  Whether this collection has no elements.
  no setterinherited
isNotEmpty → bool
  Whether this collection has at least one element.
  no setterinherited
iterator → Iterator<int>
  A new `Iterator` that allows iterating the elements of this `Iterable`.
  no setterinherited
last ↔ int
  The last element.
  getter/setter pairinherited
length ↔ int
  The number of objects in this list.
  getter/setter pairinherited
lengthInBytes → int
  The length of this view, in bytes.
  no setterinherited
offsetInBytes → int
  The offset of this view into the underlying byte buffer, in bytes.
  no setterinherited
reversed → Iterable<int>
  An Iterable of the objects in this list in reverse order.
  no setterinherited
runtimeType → Type
  A representation of the runtime type of the object.
  no setterinherited
single → int
  Checks that this iterable has only one element, and returns that element.
  no setterinherited
toJS → JSUint8ClampedArray

  Available on Uint8ClampedList, provided by the Uint8ClampedListToJSUint8ClampedArray extension

  Converts this Uint8ClampedList to a JSUint8ClampedArray by either casting, unwrapping, or cloning the Uint8ClampedList.
  no setter

## 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>
  An unmodifiable Map view of this list.
  inherited
asUnmodifiableView() → Uint8ClampedList
  A read-only view of this Uint8ClampedList.
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
  Whether 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> toElements(int element)) → Iterable<T>
  Expands each element of this Iterable into zero or more elements.
  inherited
fillRange(int start, int end, [int? fillValue]) → void
  Overwrites a range of elements with `fillValue`.
  inherited
firstWhere(bool test(int element), {int orElse()?}) → int
  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>
  Creates the lazy concatenation of this iterable and `other`.
  inherited
forEach(void action(int value)) → void
  Invokes `action` on each element of this iterable in iteration order.
  inherited
getRange(int start, int end) → Iterable<int>
  Creates an Iterable that iterates over a range of elements.
  inherited
indexOf(int element, [int start = 0]) → int
  The first index of `element` in this list.
  inherited
indexWhere(bool test(int element), [int start = 0]) → int
  The first index in the list that satisfies the provided `test`.
  inherited
insert(int index, int element) → void
  Inserts `element` 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
  The last index of `element` in this list.
  inherited
lastIndexWhere(bool test(int element), [int? start]) → int
  The last index in the list that satisfies the provided `test`.
  inherited
lastWhere(bool test(int element), {int orElse()?}) → int
  The last element that satisfies the given predicate `test`.
  inherited
map<T>(T toElement(int 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(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
  Removes and returns the last object in this list.
  inherited
removeRange(int start, int end) → void
  Removes a range of elements from the list.
  inherited
removeWhere(bool test(int element)) → void
  Removes all objects from this list that satisfy `test`.
  inherited
replaceRange(int start, int end, Iterable<int> replacements) → void
  Replaces a range of elements with the elements of `replacements`.
  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 elements with the objects of `iterable`.
  inherited
setRange(int start, int end, Iterable<int> 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(int element), {int orElse()?}) → int
  The single element that satisfies `test`.
  inherited
skip(int count) → Iterable<int>
  Creates an Iterable that provides all but the first `count` elements.
  inherited
skipWhile(bool test(int element)) → Iterable<int>
  Creates 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
  Creates a new list containing the elements between `start` and `end`.
  override
take(int count) → Iterable<int>
  Creates a lazy iterable of the `count` first elements of this iterable.
  inherited
takeWhile(bool test(int element)) → Iterable<int>
  Creates 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
  A string representation of this object.
  inherited
where(bool test(int element)) → Iterable<int>
  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<int> other) → List<int>
  The concatenation of this list and `other`.
  inherited
operator ==(Object other) → bool
  The equality operator.
  inherited
operator [](int index) → int
  The object at the given `index` in the list.
  inherited
operator []=(int index, int value) → void
  Sets the value at the given `index` in the list to `value`.
  inherited

## Constants

bytesPerElement → const int