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.
Constants
- int BYTES_PER_ELEMENT = 1
-
const
Properties
- buffer → ByteBuffer
-
read-only, inherited
Returns the byte buffer associated with this object.
- elementSizeInBytes → int
-
read-only, inherited
Returns the number of bytes in the representation of each element in this list.
- first → int
-
read-only, inherited
Returns the first element.
- isEmpty → bool
-
read-only, inherited
Returns
true
if there are no elements in this collection. - isNotEmpty → bool
-
read-only, inherited
Returns true if there is at least one element in this collection.
- iterator → Iterator<int>
-
read-only, inherited
Returns a new
Iterator
that allows iterating the elements of thisIterable
. - last → int
-
read-only, inherited
Returns the last element.
- length → int
-
read / write, inherited
Returns the number of objects in this list.
- lengthInBytes → int
-
read-only, inherited
Returns the length of this view, in bytes.
- offsetInBytes → int
-
read-only, inherited
Returns the offset in bytes into the underlying byte buffer of this view.
- reversed → Iterable<int>
-
read-only, inherited
Returns an
Iterable
of the objects in this list in reverse order. - single → int
-
read-only, inherited
Checks that this iterable has only one element, and returns that element.
Constructors
- Int8List(int length)
-
Creates an Int8List of the specified length (in elements), all of whose elements are initially zero.
- Int8List.fromList(List<int> elements)
-
Creates a Int8List with the same length as the
elements
list and copies over the elements. - Int8List.view(ByteBuffer buffer, [int offsetInBytes = 0, int length])
-
Creates an Int8List view of the specified region in
buffer
.
Operators
-
operator [](
int index) → int -
inherited
Returns the object at the given
index
in the list or throws a RangeError ifindex
is out of bounds. -
operator []=(
int index, int value) → void -
inherited
Sets the value at the given
index
in the list tovalue
or throws a RangeError ifindex
is out of bounds.
Methods
-
add(
int value) → void -
inherited
Adds
value
to the end of this list, extending the length by one. -
addAll(
Iterable<int> iterable) → void -
inherited
Appends all objects of
iterable
to the end of this list. -
any(
bool f(E element)) → bool -
inherited
Checks whether any element of this iterable satisfies
test
. -
asMap(
) → Map<int,int> -
inherited
Returns an unmodifiable Map view of
this
. -
clear(
) → void -
inherited
Removes all objects from this list; the length of the list becomes zero.
-
contains(
Object element) → bool -
inherited
Returns true if the collection contains an element equal to
element
. -
elementAt(
int index) → int -
inherited
Returns the
index
th element. -
every(
bool f(E element)) → bool -
inherited
Checks whether every element of this iterable satisfies
test
. -
expand(
Iterable f(E element)) → Iterable -
inherited
Expands each element of this Iterableinto zero or more elements.
-
fillRange(
int start, int end, [int fillValue]) → void -
inherited
Sets the objects in the range
start
inclusive toend
exclusive to the givenfillValue
. -
firstWhere(
bool test(E element), {E orElse()}) → int -
inherited
Returns the first element that satisfies the given predicate
test
. -
fold(
initialValue, dynamic combine(previousValue, E element)) → dynamic -
inherited
Reduces a collection to a single value by iteratively combining each element of the collection with an existing value
-
forEach(
void f(E element)) → void -
inherited
Applies the function
f
to each element of this collection in iteration order. -
getRange(
int start, int end) → Iterable<int> -
inherited
Returns an Iterable that iterates over the objects in the range
start
inclusive toend
exclusive. -
indexOf(
int element, [int start = 0]) → int -
inherited
Returns the first index of
element
in this list. -
insert(
int index, int element) → void -
inherited
Inserts the object at position
index
in this list. -
insertAll(
int index, Iterable<int> iterable) → void -
inherited
Inserts all objects of
iterable
at positionindex
in this list. -
join(
[String separator = ""]) → String -
inherited
Converts each element to a String and concatenates the strings.
-
lastIndexOf(
int element, [int start]) → int -
inherited
Returns the last index of
element
in this list. -
lastWhere(
bool test(E element), {E orElse()}) → int -
inherited
Returns the last element that satisfies the given predicate
test
. -
map(
dynamic f(E element)) → Iterable -
inherited
Returns a new lazy Iterable with elements that are created by calling
f
on each element of thisIterable
in iteration order. -
reduce(
E combine(E value, E element)) → int -
inherited
Reduces a collection to a single value by iteratively combining elements of the collection using the provided function.
-
remove(
Object value) → bool -
inherited
Removes the first occurence of
value
from this list. -
removeAt(
int index) → int -
inherited
Removes the object at position
index
from this list. -
removeLast(
) → int -
inherited
Pops and returns the last object in this list.
-
removeRange(
int start, int end) → void -
inherited
Removes the objects in the range
start
inclusive toend
exclusive. -
removeWhere(
bool test(E element)) → void -
inherited
Removes all objects from this list that satisfy
test
. -
replaceRange(
int start, int end, Iterable<int> replacement) → void -
inherited
Removes the objects in the range
start
inclusive toend
exclusive and inserts the contents ofreplacement
in its place. -
retainWhere(
bool test(E element)) → void -
inherited
Removes all objects from this list that fail to satisfy
test
. -
setAll(
int index, Iterable<int> iterable) → void -
inherited
Overwrites objects of
this
with the objects ofiterable
, starting at positionindex
in this list. -
setRange(
int start, int end, Iterable<int> iterable, [int skipCount = 0]) → void -
inherited
Copies the objects of
iterable
, skippingskipCount
objects first, into the rangestart
, inclusive, toend
, exclusive, of the list. -
shuffle(
[Random random]) → void -
inherited
Shuffles the elements of this list randomly.
-
singleWhere(
bool test(E element)) → int -
inherited
Returns the single element that satisfies
test
. -
skip(
int count) → Iterable<int> -
inherited
Returns an Iterable that provides all but the first
count
elements. -
skipWhile(
bool test(E value)) → Iterable<int> -
inherited
Returns an Iterable that skips leading elements while
test
is satisfied. -
sort(
[int compare(E a, E b)]) → void -
inherited
Sorts this list according to the order specified by the
compare
function. -
sublist(
int start, [int end]) → List<int> -
inherited
Returns a new list containing the objects from
start
inclusive toend
exclusive. -
take(
int count) → Iterable<int> -
inherited
Returns a lazy iterable of the
count
first elements of this iterable. -
takeWhile(
bool test(E value)) → Iterable<int> -
inherited
Returns a lazy iterable of the leading elements satisfying
test
. -
toList(
{bool growable: true}) → List<int> -
inherited
-
toSet(
) → Set<int> -
inherited
Creates a Set containing the same elements as this iterable.
-
where(
bool f(E element)) → Iterable<int> -
inherited
Returns a new lazy Iterable with all elements that satisfy the predicate
test
.