description

# Uint8List 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 truncated to their low eight bits, interpreted as an unsigned 8-bit integer with values in the range 0 to 255.

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

Implemented types
  - TypedDataList<int>
Available extensions
  - Uint8ListAddress
  - Uint8ListToJSUint8Array

## Constructors

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

## Properties

address → Pointer<Uint8>

  Available on Uint8List, provided by the Uint8ListAddress extension

  The memory address of the underlying data.
  no setter
buffer → ByteBuffer
  The byte buffer associated with this object.
  no setter inherited
elementSizeInBytes → int
  The number of bytes in the representation of each element in this list.
  no setter inherited
first ↔ int
  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<int>
  A new `Iterator` that allows iterating the elements of this `Iterable`.
  no setter inherited
last ↔ int
  The last element.
  getter/setter pair inherited
length ↔ int
  The number of objects in this list.
  getter/setter pair inherited
lengthInBytes → int
  The length of this view, in bytes.
  no setter inherited
offsetInBytes → int
  The offset of this view into the underlying byte buffer, in bytes.
  no setter inherited
reversed → Iterable<int>
  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 → int
  Checks that this iterable has only one element, and returns that element.
  no setter inherited
toJS → JSUint8Array

  Available on Uint8List, provided by the Uint8ListToJSUint8Array extension

  Converts this Uint8List to a JSUint8Array by either casting, unwrapping, or cloning the Uint8List.
  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() → Uint8List
  A read-only view of this Uint8List.
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]) → Uint8List
  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>
  Returns a concatenation of this list and `other`.
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