Int8List class abstract final

A fixed-length list of 8-bit signed 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 a signed 8-bit two's complement integer with values in the range -128 to +127.

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

Implemented types

TypedDataList<int>

Available extensions

Constructors

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

Properties

address → Pointer<Int8>: Available on Int8List, provided by the Int8ListAddress extension
The memory address of the underlying data.
no setter
average → double: Available on Iterable<int>, provided by the IterableIntegerExtension extension
The arithmetic mean of the elements of a non-empty iterable.
no setter
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
max → int: Available on Iterable<int>, provided by the IterableIntegerExtension extension
A maximal element of the iterable.
no setter
maxOrNull → int?: Available on Iterable<int>, provided by the IterableIntegerExtension extension
A maximal element of the iterable, or null if the iterable is empty.
no setter
min → int: Available on Iterable<int>, provided by the IterableIntegerExtension extension
A minimal element of the iterable.
no setter
minOrNull → int?: Available on Iterable<int>, provided by the IterableIntegerExtension extension
A minimal element of the iterable, or null it the iterable is empty.
no setter
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
sum → int: Available on Iterable<int>, provided by the IterableIntegerExtension extension
The sum of the elements.
no setter
toJS → JSInt8Array: Available on Int8List, provided by the Int8ListToJSInt8Array extension
Converts this Int8List to a JSInt8Array by either casting, unwrapping, or cloning the Int8List.
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() → Int8List: A read-only view of this Int8List;
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 indexth 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 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 value)) → 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]) → Int8List: 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 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 to value.
inherited

Constants

bytesPerElement → const int