reactivestate-core/com.ensody.reactivestate/ContextualValSuspend

ContextualValSuspend

class ContextualValSuspend<T>(val name: String, var default: suspend (CoroutineContext) -> T)

A val for which the value can be set via the coroutineContext.

This is similar to a thread-local or the "dynamic scope" concept.

The default value is created lazily on demand per CoroutineScope (not globally!). For this to work you have to inject ContextualValRoot into each CoroutineScope that wants to support this class.

The name is only used to help with debugging.

Also see ContextualVal for a blocking version (not suspend).

Constructors

ContextualValSuspend

constructor(name: String, default: suspend (CoroutineContext) -> T)

Types

ContextElement

class ContextElement<T>(val key: ContextualValSuspend.ContextKey<T>, valueGetter: suspend (CoroutineContext) -> T) : CoroutineContext.Element

ContextKey

class ContextKey<T>(val value: ContextualValSuspend<T>) : CoroutineContext.Key<ContextualValSuspend.ContextElement<T>>

Properties

default

var default: suspend (CoroutineContext) -> T

key

val key: ContextualValSuspend.ContextKey<T>

name

val name: String

Functions

get

suspend fun get(): T

Gets the value for the current coroutineContext.

suspend fun get(context: CoroutineContext): T

Gets the value for the given context.

suspend fun get(scope: CoroutineScope): T

Gets the value for the given scope.

toString

open override fun toString(): String

valued

fun valued(block: suspend (CoroutineContext) -> T): CoroutineContext.Element

The returned CoroutineContext.Element can used to set a value via CoroutineScope.plus.

with

suspend fun <R> with(value: T, block: suspend () -> R): R

Sets a new value that only exists within block.