driver/io.github.octaviusframework.driver.registry/IntObjectMap

IntObjectMap

A highly optimized, primitive-key map implementation that maps primitive Int keys to object values.

This implementation avoids the memory and performance overhead of autoboxing integers into java.lang.Integer objects, which occurs when using standard collections like HashMap<Int, V>. It utilizes open addressing with linear probing for fast lookups and insertions.

Note: The key 0 is reserved internally as an empty slot indicator and cannot be used.

Type Parameters

the type of values maintained by this map

Constructors

IntObjectMap

constructor(capacity: Int = 128)

constructor(other: IntObjectMap<V>)

Properties

entries

val entries: List<Map.Entry<Int, V>>

size

val size: Int

values

val values: List<V>

Functions

containsKey

fun containsKey(key: Int): Boolean

Whether key has a value. Since the map holds no nulls, this is get(key) != null.

forEach

fun forEach(action: (key: Int, value: V) -> Unit)

Runs action for every entry, walking the table directly so that nothing is allocated to iterate - no entry objects, no boxed keys.

get

operator fun get(key: Int): V?

The value stored under key, or null if there is none. A lookup for 0 is null rather than an error, so the reserved key reads as absent on the way out even though it is refused on the way in.

isEmpty

fun isEmpty(): Boolean

Whether the map holds nothing.

isNotEmpty

fun isNotEmpty(): Boolean

Whether the map holds anything.

put

fun put(key: Int, value: V)

Stores value under key, growing and rehashing the table when it passes its load factor.

set

operator fun set(key: Int, value: V)

put, written as map[key] = value.