FloatList


Known direct subclasses
MutableFloatList

MutableFloatList is a MutableList-like collection for Float values.


FloatList is a List-like collection for Float values. It allows retrieving the elements without boxing. FloatList is always backed by a MutableFloatList, its MutableList-like subclass.

This implementation is not thread-safe: if multiple threads access this container concurrently, and one or more threads modify the structure of the list (insertion or removal for instance), the calling code must provide the appropriate synchronization. It is also not safe to mutate during reentrancy -- in the middle of a forEach, for example. However, concurrent reads are safe.

Summary

Protected constructors

FloatList(initialCapacity: Int)
Cmn

Public functions

Boolean
any()

Returns true if there's at least one element in the collection.

Cmn
inline Boolean
any(predicate: (element: Float) -> Boolean)

Returns true if any of the elements give a true return value for predicate.

Cmn
operator Boolean
contains(element: Float)

Returns true if the FloatList contains element or false otherwise.

Cmn
Boolean

Returns true if the FloatList contains all elements in elements or false if one or more are missing.

Cmn
Int

Returns the number of elements in this list.

Cmn
inline Int
count(predicate: (element: Float) -> Boolean)

Counts the number of elements matching predicate.

Cmn
Float
elementAt(index: @IntRange(from = 0) Int)

Returns the element at the given index or throws IndexOutOfBoundsException if the index is out of bounds of this collection.

Cmn
inline Float
elementAtOrElse(
    index: @IntRange(from = 0) Int,
    defaultValue: (index: Int) -> Float
)

Returns the element at the given index or defaultValue if index is out of bounds of the collection.

Cmn
open operator Boolean
equals(other: Any?)

Returns true if other is a FloatList and the contents of this and other are the same.

Cmn
Float

Returns the first element in the FloatList or throws a NoSuchElementException if it isEmpty.

Cmn
inline Float
first(predicate: (element: Float) -> Boolean)

Returns the first element in the FloatList for which predicate returns true or throws NoSuchElementException if nothing matches.

Cmn
inline R
<R : Any?> fold(initial: R, operation: (acc, element: Float) -> R)

Accumulates values, starting with initial, and applying operation to each element in the FloatList in order.

Cmn
inline R
<R : Any?> foldIndexed(initial: R, operation: (index: Int, acc, element: Float) -> R)

Accumulates values, starting with initial, and applying operation to each element in the FloatList in order.

Cmn
inline R
<R : Any?> foldRight(initial: R, operation: (element: Float, acc) -> R)

Accumulates values, starting with initial, and applying operation to each element in the FloatList in reverse order.

Cmn
inline R
<R : Any?> foldRightIndexed(
    initial: R,
    operation: (index: Int, element: Float, acc) -> R
)

Accumulates values, starting with initial, and applying operation to each element in the FloatList in reverse order.

Cmn
inline Unit
forEach(block: (element: Float) -> Unit)

Calls block for each element in the FloatList, in order.

Cmn
inline Unit
forEachIndexed(block: (index: Int, element: Float) -> Unit)

Calls block for each element in the FloatList along with its index, in order.

Cmn
inline Unit
forEachReversed(block: (element: Float) -> Unit)

Calls block for each element in the FloatList in reverse order.

Cmn
inline Unit
forEachReversedIndexed(block: (index: Int, element: Float) -> Unit)

Calls block for each element in the FloatList along with its index, in reverse order.

Cmn
operator Float
get(index: @IntRange(from = 0) Int)

Returns the element at the given index or throws IndexOutOfBoundsException if the index is out of bounds of this collection.

Cmn
open Int

Returns a hash code based on the contents of the FloatList.

Cmn
Int
indexOf(element: Float)

Returns the index of element in the FloatList or -1 if element is not there.

Cmn
inline Int
indexOfFirst(predicate: (element: Float) -> Boolean)

Returns the index if the first element in the FloatList for which predicate returns true.

Cmn
inline Int
indexOfLast(predicate: (element: Float) -> Boolean)

Returns the index if the last element in the FloatList for which predicate returns true.

Cmn
Boolean

Returns true if the FloatList has no elements in it or false otherwise.

Cmn
Boolean

Returns true if there are elements in the FloatList or false if it is empty.

Cmn
String
joinToString(
    separator: CharSequence,
    prefix: CharSequence,
    postfix: CharSequence,
    limit: Int,
    truncated: CharSequence
)

Creates a String from the elements separated by separator and using prefix before and postfix after, if supplied.

Cmn
inline String
joinToString(
    separator: CharSequence,
    prefix: CharSequence,
    postfix: CharSequence,
    limit: Int,
    truncated: CharSequence,
    crossinline transform: (Float) -> CharSequence
)

Creates a String from the elements separated by separator and using prefix before and postfix after, if supplied.

Cmn
Float

Returns the last element in the FloatList or throws a NoSuchElementException if it isEmpty.

Cmn
inline Float
last(predicate: (element: Float) -> Boolean)

Returns the last element in the FloatList for which predicate returns true or throws NoSuchElementException if nothing matches.

Cmn
Int
lastIndexOf(element: Float)

Returns the index of the last element in the FloatList that is the same as element or -1 if no elements match.

Cmn
Boolean

Returns true if the collection has no elements in it.

Cmn
inline Boolean
reversedAny(predicate: (element: Float) -> Boolean)

Returns true if any of the elements give a true return value for predicate while iterating in the reverse order.

Cmn
open String

Returns a String representation of the list, surrounded by "[]" and each element separated by ", ".

Cmn

Public properties

IntRange

Returns an IntRange of the valid indices for this FloatList.

Cmn
Int

Returns the last valid index in the FloatList.

Cmn
Int

The number of elements in the FloatList.

Cmn

Protected constructors

FloatList

protected FloatList(initialCapacity: Int)

Public functions

any

fun any(): Boolean

Returns true if there's at least one element in the collection.

any

inline fun any(predicate: (element: Float) -> Boolean): Boolean

Returns true if any of the elements give a true return value for predicate.

contains

operator fun contains(element: Float): Boolean

Returns true if the FloatList contains element or false otherwise.

containsAll

fun containsAll(elements: FloatList): Boolean

Returns true if the FloatList contains all elements in elements or false if one or more are missing.

count

fun count(): Int

Returns the number of elements in this list.

count

inline fun count(predicate: (element: Float) -> Boolean): Int

Counts the number of elements matching predicate.

Returns
Int

The number of elements in this list for which predicate returns true.

elementAt

fun elementAt(index: @IntRange(from = 0) Int): Float

Returns the element at the given index or throws IndexOutOfBoundsException if the index is out of bounds of this collection.

elementAtOrElse

inline fun elementAtOrElse(
    index: @IntRange(from = 0) Int,
    defaultValue: (index: Int) -> Float
): Float

Returns the element at the given index or defaultValue if index is out of bounds of the collection.

Parameters
index: Int

The index of the element whose value should be returned

defaultValue: (index: Int) -> Float

A lambda to call with index as a parameter to return a value at an index not in the list.

equals

open operator fun equals(other: Any?): Boolean

Returns true if other is a FloatList and the contents of this and other are the same.

first

fun first(): Float

Returns the first element in the FloatList or throws a NoSuchElementException if it isEmpty.

first

inline fun first(predicate: (element: Float) -> Boolean): Float

Returns the first element in the FloatList for which predicate returns true or throws NoSuchElementException if nothing matches.

See also
indexOfFirst

fold

inline fun <R : Any?> fold(initial: R, operation: (acc, element: Float) -> R): R

Accumulates values, starting with initial, and applying operation to each element in the FloatList in order.

Parameters
initial: R

The value of acc for the first call to operation or return value if there are no elements in this list.

operation: (acc, element: Float) -> R

function that takes current accumulator value and an element, and calculates the next accumulator value.

foldIndexed

inline fun <R : Any?> foldIndexed(initial: R, operation: (index: Int, acc, element: Float) -> R): R

Accumulates values, starting with initial, and applying operation to each element in the FloatList in order.

foldRight

inline fun <R : Any?> foldRight(initial: R, operation: (element: Float, acc) -> R): R

Accumulates values, starting with initial, and applying operation to each element in the FloatList in reverse order.

Parameters
initial: R

The value of acc for the first call to operation or return value if there are no elements in this list.

operation: (element: Float, acc) -> R

function that takes an element and the current accumulator value, and calculates the next accumulator value.

foldRightIndexed

inline fun <R : Any?> foldRightIndexed(
    initial: R,
    operation: (index: Int, element: Float, acc) -> R
): R

Accumulates values, starting with initial, and applying operation to each element in the FloatList in reverse order.

forEach

inline fun forEach(block: (element: Float) -> Unit): Unit

Calls block for each element in the FloatList, in order.

Parameters
block: (element: Float) -> Unit

will be executed for every element in the list, accepting an element from the list

forEachIndexed

inline fun forEachIndexed(block: (index: Int, element: Float) -> Unit): Unit

Calls block for each element in the FloatList along with its index, in order.

Parameters
block: (index: Int, element: Float) -> Unit

will be executed for every element in the list, accepting the index and the element at that index.

forEachReversed

inline fun forEachReversed(block: (element: Float) -> Unit): Unit

Calls block for each element in the FloatList in reverse order.

Parameters
block: (element: Float) -> Unit

will be executed for every element in the list, accepting an element from the list

forEachReversedIndexed

inline fun forEachReversedIndexed(block: (index: Int, element: Float) -> Unit): Unit

Calls block for each element in the FloatList along with its index, in reverse order.

Parameters
block: (index: Int, element: Float) -> Unit

will be executed for every element in the list, accepting the index and the element at that index.

get

operator fun get(index: @IntRange(from = 0) Int): Float

Returns the element at the given index or throws IndexOutOfBoundsException if the index is out of bounds of this collection.

hashCode

open fun hashCode(): Int

Returns a hash code based on the contents of the FloatList.

indexOf

fun indexOf(element: Float): Int

Returns the index of element in the FloatList or -1 if element is not there.

indexOfFirst

inline fun indexOfFirst(predicate: (element: Float) -> Boolean): Int

Returns the index if the first element in the FloatList for which predicate returns true.

indexOfLast

inline fun indexOfLast(predicate: (element: Float) -> Boolean): Int

Returns the index if the last element in the FloatList for which predicate returns true.

isEmpty

fun isEmpty(): Boolean

Returns true if the FloatList has no elements in it or false otherwise.

isNotEmpty

fun isNotEmpty(): Boolean

Returns true if there are elements in the FloatList or false if it is empty.

joinToString

fun joinToString(
    separator: CharSequence = ", ",
    prefix: CharSequence = "",
    postfix: CharSequence = "",
    limit: Int = -1,
    truncated: CharSequence = "..."
): String

Creates a String from the elements separated by separator and using prefix before and postfix after, if supplied.

When a non-negative value of limit is provided, a maximum of limit items are used to generate the string. If the collection holds more than limit items, the string is terminated with truncated.

joinToString

inline fun joinToString(
    separator: CharSequence = ", ",
    prefix: CharSequence = "",
    postfix: CharSequence = "",
    limit: Int = -1,
    truncated: CharSequence = "...",
    crossinline transform: (Float) -> CharSequence
): String

Creates a String from the elements separated by separator and using prefix before and postfix after, if supplied. transform dictates how each element will be represented.

When a non-negative value of limit is provided, a maximum of limit items are used to generate the string. If the collection holds more than limit items, the string is terminated with truncated.

last

fun last(): Float

Returns the last element in the FloatList or throws a NoSuchElementException if it isEmpty.

last

inline fun last(predicate: (element: Float) -> Boolean): Float

Returns the last element in the FloatList for which predicate returns true or throws NoSuchElementException if nothing matches.

See also
indexOfLast

lastIndexOf

fun lastIndexOf(element: Float): Int

Returns the index of the last element in the FloatList that is the same as element or -1 if no elements match.

none

fun none(): Boolean

Returns true if the collection has no elements in it.

reversedAny

inline fun reversedAny(predicate: (element: Float) -> Boolean): Boolean

Returns true if any of the elements give a true return value for predicate while iterating in the reverse order.

toString

open fun toString(): String

Returns a String representation of the list, surrounded by "[]" and each element separated by ", ".

Public properties

indices

val indicesIntRange

Returns an IntRange of the valid indices for this FloatList.

lastIndex

val lastIndexInt

Returns the last valid index in the FloatList. This can be -1 when the list is empty.

size

val sizeInt

The number of elements in the FloatList.