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
- Available extensions
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 thisIterable
.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 element)) → 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 positionindex
in this list.inherited -
insertAll(
int index, Iterable< int> iterable) → void -
Inserts all objects of
iterable
at positionindex
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 value)) → Iterable< int> -
Creates an
Iterable
that skips leading elements whiletest
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
andend
.override -
take(
int count) → Iterable< int> -
Creates a lazy iterable of the
count
first elements of this iterable.inherited -
takeWhile(
bool test(int value)) → 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 tovalue
.inherited
Constants
- bytesPerElement → const int