core/com.composables.core.androidx.collection/MutableScatterSet

MutableScatterSet

class MutableScatterSet<E>(initialCapacity: Int = DefaultScatterCapacity) : ScatterSet<E>

MutableScatterSet is a container with a MutableSet-like interface based on a flat hash table implementation. The underlying implementation is designed to avoid all allocations on insertion, removal, retrieval, and iteration. Allocations may still happen on insertion when the underlying storage needs to grow to accommodate newly added elements to the set.

This implementation makes no guarantee as to the order of the elements stored, nor does it make guarantees that the order remains constant over time.

This implementation is not thread-safe: if multiple threads access this container concurrently, and one or more threads modify the structure of the set (insertion or removal for instance), the calling code must provide the appropriate synchronization. Concurrent reads are however safe.

Note: when a Set is absolutely necessary, you can use the method asSet to create a thin wrapper around a MutableScatterSet. Please refer to asSet for more details and caveats.

Note: when a MutableSet is absolutely necessary, you can use the method asMutableSet to create a thin wrapper around a MutableScatterSet. Please refer to asMutableSet for more details and caveats.

Parameters

initialCapacity

The initial desired capacity for this container. the container will honor this value by guaranteeing its internal structures can hold that many elements without requiring any allocations. The initial capacity can be set to 0.

Constructors

MutableScatterSet

constructor(initialCapacity: Int = DefaultScatterCapacity)

Creates a new MutableScatterSet

Properties

capacity

@get:IntRange(from = 0)

val capacity: Int

Returns the number of elements that can be stored in this set without requiring internal storage reallocation.

size

@get:IntRange(from = 0)

val size: Int

Returns the number of elements in this set.

Functions

add

fun add(element: E): Boolean

Adds the specified element to the set.

addAll

fun addAll(elements: ScatterSet<E>): Boolean

fun addAll(elements: ObjectList<E>): Boolean

Adds all the elements in the elements set into this set.

fun addAll(elements: Array<out E>): Boolean

fun addAll(elements: Iterable<E>): Boolean

fun addAll(elements: Sequence<E>): Boolean

Adds all the elements into this set.

all

inline fun all(predicate: (element: E) -> Boolean): Boolean

Returns true if all elements match the given predicate. If there are no elements in the set, true is returned.

any

fun any(): Boolean

Returns true if this set has at least one element.

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

Returns true if at least one element matches the given predicate.

asMutableSet

fun asMutableSet(): MutableSet<E>

Wraps this ScatterSet with a MutableSet interface. The MutableSet is backed by the ScatterSet, so changes to the ScatterSet are reflected in the MutableSet and vice-versa. If the ScatterSet is modified while an iteration over the MutableSet is in progress (and vice- versa), the results of the iteration are undefined.

asSet

fun asSet(): Set<E>

Wraps this ScatterSet with a Set interface. The Set is backed by the ScatterSet, so changes to the ScatterSet are reflected in the Set. If the ScatterSet is modified while an iteration over the Set is in progress, the results of the iteration are undefined.

clear

fun clear()

Removes all elements from this set.

contains

operator fun contains(element: E): Boolean

Returns true if the specified element is present in this hash set, false otherwise.

count

@IntRange(from = 0)

fun count(): Int

Returns the number of elements in this set.

@IntRange(from = 0)

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

Returns the number of elements matching the given predicate.

equals

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

Compares the specified object other with this hash set for equality. The two objects are considered equal if other:

first

inline fun first(): E

Returns the first element in the collection.

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

Returns the first element in the collection for which predicate returns true

firstOrNull

inline fun firstOrNull(predicate: (element: E) -> Boolean): E?

Returns the first element in the collection for which predicate returns true or null if there are no elements that match predicate.

forEach

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

Iterates over every element stored in this set by invoking the specified block lambda.

hashCode

open override fun hashCode(): Int

Returns the hash code value for this set. The hash code of a set is defined to be the sum of the hash codes of the elements in the set, where the hash code of a null element is defined to be zero

isEmpty

fun isEmpty(): Boolean

Indicates whether this set is empty.

isNotEmpty

fun isNotEmpty(): Boolean

Returns true if this set is not empty.

joinToString

@JvmOverloads