utils/dev.kindling.utils.state/KStack

KStack

class KStack<T>(initialItems: List<T> = emptyList())(source)

A reactive LIFO stack.

Pairs naturally with KQueue for producer/consumer patterns.

val stack = KStack<String>()
stack.push("first")
stack.push("second")

println(stack.peek())  // "second"
println(stack.pop())   // "second"
println(stack.size)    // 1

stack.state.collect { items -> render(items) }

Parameters

initialItems

Items to pre-populate (index 0 = bottom of stack).

Constructors

KStack

constructor(initialItems: List<T> = emptyList())

Properties

isEmpty

val isEmpty: Boolean

true when the stack contains no items.

size

val size: Int

Number of items currently in the stack.

state

val state: StateFlow<List<T>>

Stack contents as a StateFlow (index 0 = bottom, last = top).

Functions

clear

fun clear()

Removes all items.

peek

fun peek(): T?

Returns the top item without removing it, or null if empty.

pop

fun pop(): T?

Removes and returns the top item, or null if empty.

push

fun push(item: T)

Pushes item onto the top of the stack.

toString

open override fun toString(): String