types/kotools.types.collection

Package-level declarations

Contains types such as NotEmptyList for manipulating collections.

Types

NotEmptyCollection

sealed interface NotEmptyCollection<out E>

Represents a collection that has at least one element of type E.

NotEmptyList

@JvmInline

@Serializable(with = NotEmptyListSerializer::class)

value class NotEmptyList<out E> : NotEmptyCollection<E>

Represents a list that has at least one element of type E.

NotEmptyMap

@JvmInline

@Serializable(with = NotEmptyMapSerializer::class)

value class NotEmptyMap<K, out V>

Represents a map that has at least one entry, with a key of type K and a value of type V.

NotEmptySet

@JvmInline

@Serializable(with = NotEmptySetSerializer::class)

value class NotEmptySet<out E> : NotEmptyCollection<E>

Represents a set that has at least one element of type E.

Properties

sizeOrZero

val NotEmptyCollection<*>?.sizeOrZero: PositiveInt

Returns the size of this collection, or returns ZeroInt if this collection is null.

Functions

notEmptyListOf

fun <E> notEmptyListOf(head: E, vararg tail: E): NotEmptyList<E>

Creates a NotEmptyList starting with a head and containing all the elements of the optional tail.

notEmptyMapOf

fun <K, V> notEmptyMapOf(head: Pair<K, V>, vararg tail: Pair<K, V>): NotEmptyMap<K, V>

Creates a NotEmptyMap starting with a head and containing all the entries of the optional tail.

notEmptySetOf

fun <E> notEmptySetOf(head: E, vararg tail: E): NotEmptySet<E>

Creates a NotEmptySet starting with a head and containing all the elements of the optional tail.

toNotEmptyList

fun <E> Collection<E>.toNotEmptyList(): Result<NotEmptyList<E>>

Returns an encapsulated NotEmptyList containing all the elements of this collection, or returns an encapsulated IllegalArgumentException if this collection is empty.

toNotEmptyMap

fun <K, V> Map<K, V>.toNotEmptyMap(): Result<NotEmptyMap<K, V>>

Returns an encapsulated NotEmptyMap containing all the entries of this map, or returns an encapsulated IllegalArgumentException if this map is empty.

toNotEmptySet

fun <E> Collection<E>.toNotEmptySet(): Result<NotEmptySet<E>>

Returns an encapsulated NotEmptySet containing all the elements of this collection, or returns an encapsulated IllegalArgumentException if this collection is empty.