Field

sealed interface Field<ID : Any, out T>

A field is a map of messages where the key is the ID of a node and T the associated value.

Types

Companion

object Companion

Base operations on Fields.

Properties

localId

abstract val localId: ID

The ID of the local node.

localValue

abstract val localValue: T

The value associated with the localId.

neighbors

abstract val neighbors: Collection<ID>

Returns the IDs of all neighbors in this field.

neighborsCount

open val neighborsCount: Int

Returns the number of neighbors of the field.

Functions

alignedMap

open fun <B, R> alignedMap(other: Field<ID, B>, transform: (T, B) -> R): Field<ID, R>

Combines this field with another (aligned) one.

all

inline fun <ID : Any, T> Field<ID, T>.all(crossinline predicate: (T) -> Boolean): Boolean

Check if all the elements in the field satisfy the predicate, ignoring the local value.

@JvmOverloads

fun <ID : Any> Field<ID, Boolean>.all(base: Boolean, predicate: (Boolean) -> Boolean = { it }): Boolean

Check if all the Boolean elements in the field are true by default. If predicate is defined, it is applied to the elements. The base value is used as a first element to start the fold operation at which the predicate is applied.

allWithSelf

inline fun <ID : Any, T> Field<ID, T>.allWithSelf(crossinline predicate: (T) -> Boolean): Boolean

Check if all the elements in the field satisfy the predicate, including the local value.

any

inline fun <ID : Any, T> Field<ID, T>.any(crossinline predicate: (T) -> Boolean): Boolean

Check if any of the elements in the field satisfy the predicate, ignoring the local value.

@JvmOverloads

fun <ID : Any> Field<ID, Boolean>.any(base: Boolean, predicate: (Boolean) -> Boolean = { it }): Boolean

Check if any of the Boolean elements in the field are true by default. If predicate is defined, it is applied to the elements. The base value is used as a first element to start the fold operation at which the predicate is applied.

anyWithSelf

inline fun <ID : Any, T> Field<ID, T>.anyWithSelf(crossinline predicate: (T) -> Boolean): Boolean

Check if any of the elements in the field satisfy the predicate, including the local value.

asSequence

abstract fun asSequence(): Sequence<Pair<ID, T>>

Transform the field into a map.

count

@JvmOverloads

inline fun <ID : Any, T> Field<ID, T>.count(crossinline predicate: (T) -> Boolean = { true }): Int

Count the number of elements in the field that satisfy the predicate, ignoring the local value.

countWithSelf

@JvmOverloads

inline fun <ID : Any, T> Field<ID, T>.countWithSelf(crossinline predicate: (T) -> Boolean = { true }): Int

Count the number of elements in the field that satisfy the predicate, including the local value.

excludeSelf

abstract fun excludeSelf(): Map<ID, T>

Returns a Map with the neighboring values of this field (namely, all values but self).

fold

fun <ID : Any, T, R> Field<ID, T>.fold(initial: R, transform: (R, T) -> R): R

Folds the elements of a field starting with an initial through a transform function. The local value is not considered, unless explicitly passed as initial.

get

abstract operator fun get(id: ID): T

Get the value associated with the id. Raise an error if the id is not present in the field.

hood

fun <ID : Any, T> Field<ID, T>.hood(default: T, transform: (T, T) -> T): T

Reduce the elements of the field using the transform function. The local value is not considered, unless explicitly passed as default.

map

open fun <B> map(transform: (T) -> B): Field<ID, B>

Map the field using the transform function.

mapToConstantField

open fun <B> mapToConstantField(singleton: B): Field<ID, B>

Map the field resulting in a new one where the value for the local and the neighbors is singleton.

mapWithId

abstract fun <B> mapWithId(transform: (ID, T) -> B): Field<ID, B>

Map the field using the transform function.

max

fun <ID : Any, T : Comparable<T>> Field<ID, T>.max(base: T): T

Get the maximum value of a field, excluding the local value, starting from base. To consider the local value, explicitly provide it as base.

maxBy

inline fun <ID : Any, T, R : Comparable<R>> Field<ID, T>.maxBy(base: T, crossinline selector: (T) -> R): T

Returns the element yielding the largest value of the given selector. In case multiple elements are maximal, there is no guarantee which one will be returned.

maxWith

fun <ID : Any, T> Field<ID, T>.maxWith(base: T, comparator: Comparator<T>): T

Returns the element yielding the largest value of the given comparator. In case multiple elements are maximal, there is no guarantee which one will be returned.

maxWithSelf

fun <ID : Any, T : Comparable<T>> Field<ID, T>.maxWithSelf(): T

Get the maximum value of a field, including the local value.

min

fun <ID : Any, T : Comparable<T>> Field<ID, T>.min(base: T): T

Get the minimum value of a field, excluding the local value, starting from base. To consider the local value, explicitly provide it as base.

minBy

inline fun <ID : Any, T, R : Comparable<R>> Field<ID, T>.minBy(base: T, crossinline selector: (T) -> R): T

Returns the element yielding the smallest value of the given selector. In case multiple elements are minimal, there is no guarantee which one will be returned.

minWith

fun <ID : Any, T> Field<ID, T>.minWith(base: T, comparator: Comparator<T>): T

Returns the element yielding the smallest value of the given comparator. In case multiple elements are minimal, there is no guarantee which one will be returned.

minWithSelf

fun <ID : Any, T : Comparable<T>> Field<ID, T>.minWithSelf(): T

Get the minimum value of a field, including the local value.

none

inline fun <ID : Any, T> Field<ID, T>.none(crossinline predicate: (T) -> Boolean): Boolean

Check if none of the elements in the field satisfy the predicate, ignoring the local value.

@JvmOverloads

fun <ID : Any> Field<ID, Boolean>.none(base: Boolean, predicate: (Boolean) -> Boolean = { it }): Boolean

Check if none of the Boolean elements in the field are true by default. If predicate is defined, it is applied to the elements. The base value is used as a first element to start the fold operation at which the predicate is applied.

noneWithSelf

inline fun <ID : Any, T> Field<ID, T>.noneWithSelf(crossinline predicate: (T) -> Boolean): Boolean

Check if none of the elements in the field satisfy the predicate, including the local value.

toMap

abstract fun toMap(): Map<ID, T>

Converts the Field into a Map. This method is meant to bridge the aggregate APIs with the Kotlin collections framework. The resulting map will contain the local value.