Kubit/kubit.collections.deque/FloatDeque

FloatDeque

class FloatDeque(initialCapacity: Int)(source)

FloatDeque is a double-ended queue for Float values backed by a circular buffer.

Amortized O(1) insertion/removal at both ends.
Indexed access, insertion and removal are supported (may shift elements internally).
Not thread-safe: synchronize externally if multiple threads mutate concurrently.

Throws

IllegalArgumentException

if initialCapacity is negative.

Constructors

FloatDeque

constructor(initialCapacity: Int)

Creates a deque with the given initialCapacity. The deque grows automatically as needed when elements are added beyond the current capacity.

Properties

lastIndex

val lastIndex: Int

The last valid element index, or -1 when the deque is empty.

size

val size: Int

The number of elements in this deque.

Functions

add

fun add(value: Float)

Adds value to the end of this deque. Alias for addLast.

fun add(index: Int, value: Float)

Inserts value at index. Elements may be shifted to make room for the new element.

addFirst

fun addFirst(value: Float)

Adds value to the front (head) of this deque.

addLast

fun addLast(value: Float)

Adds value to the end of this deque.

asList

fun FloatDeque.asList(): List<Float>

Returns a live List view backed by this deque.

asMutableList

fun FloatDeque.asMutableList(): MutableList<Float>

Returns a live MutableList view backed by this deque. Structural changes are reflected both ways.

clear

fun clear()

Removes all elements from this deque. Capacity is preserved.

contains

operator fun contains(value: Float): Boolean

Returns true if value exists in this deque.

dequeue

fun dequeue(): Float

Dequeues and returns the front element (queue-style). Alias for removeFirst.

enqueue

fun enqueue(value: Float)

Enqueues value at the end (queue-style). Alias for addLast.

first

fun first(): Float

Returns the first element, or throws if this deque is empty.

firstOrNull

fun firstOrNull(): Float?

Returns the first element, or null if this deque is empty.

forEach

inline fun forEach(action: (Float) -> Unit)

Iterates elements from first to last, invoking action for each element.

forEachIndexed

inline fun forEachIndexed(action: (index: Int, value: Float) -> Unit)

Iterates elements from first to last, passing the logical index and value to action.

forEachReversed

inline fun forEachReversed(action: (Float) -> Unit)

Iterates elements from last to first, invoking action for each element.

forEachReversedIndexed

inline fun forEachReversedIndexed(action: (index: Int, value: Float) -> Unit)

Iterates elements from last to first, passing the logical index and value to action.

get

operator fun get(index: Int): Float

Returns the element at index.

indexOf

fun indexOf(value: Float): Int

Returns the index of the first occurrence of value, or -1 if not found.

isEmpty

inline fun isEmpty(): Boolean

Returns true if this deque contains no elements.

isNotEmpty

inline fun isNotEmpty(): Boolean

Returns true if this deque contains one or more elements.

last

fun last(): Float

Returns the last element, or throws if this deque is empty.

lastIndexOf

fun lastIndexOf(value: Float): Int

Returns the index of the last occurrence of value, or -1 if not found.

lastOrNull

fun lastOrNull(): Float?

Returns the last element, or null if this deque is empty.

pop

fun pop(): Float

Pops and returns the front element (stack-style). Alias for removeFirst.

push

fun push(value: Float)

Pushes value onto the front (stack-style). Alias for addFirst.

removeAt

fun removeAt(index: Int): Float

Removes and returns the element at index. The internal storage may shift elements towards either end to fill the gap.

removeFirst

fun removeFirst(): Float

Removes and returns the first element.

removeFirstOrNull

fun removeFirstOrNull(): Float?

Removes and returns the first element, or null if the deque is empty.

removeLast

fun removeLast(): Float

Removes and returns the last element.

removeLastOrNull

fun removeLastOrNull(): Float?

Removes and returns the last element, or null if the deque is empty.

set

operator fun set(index: Int, value: Float): Float

Replaces the element at index with value.