signalRefresh (Function)

Signature: signalRefresh(cached: { dependencies: List<string>, revision: int, value: t0 }, changed: List<string>, work: () -> t0) -> { dependencies: List<string>, revision: int, value: t0 }

Description: Rebuilds an immutable snapshot when a dependency changes, its callback dependency set changes or dependencies remain unknown. Otherwise returns the cached snapshot.

Parameters

  • cached ({ dependencies: List<string>, revision: int, value: t0 }): The previous snapshot
  • changed (List<string>): Changed signal operation identities
  • work (() -> t0): The computation using current signal values

Returns: { dependencies: List<string>, revision: int, value: t0 }

Example

static effect Signal<T> { read: fn() -> T }
type Count = { value: int }
fn readCount() = (perform Signal<Count>.read()).value
fn counterLabel() = "count=${readCount()}"
let cached = {
    handle static Signal<Count> { read => Count { value: 1 } }
    signalSnapshot(counterLabel)
}
let updated = {
    handle static Signal<Count> { read => Count { value: 2 } }
    signalRefresh(cached, signalDependencies(readCount), counterLabel)
}
print("${updated.value}; revision=${updated.revision}; ${join(signalDependencies(counterLabel), ",")}")
static effect Signal T
    read : Unit => T
type Count =
    value : int
readCount () = (perform Signal<Count>.read ()).value
counterLabel () = "count=${readCount ()}"
cached =
    handle static Signal<Count>
        read => Count(value = 1)
    signalSnapshot counterLabel
updated =
    handle static Signal<Count>
        read => Count(value = 2)
    signalRefresh (cached, signalDependencies readCount, counterLabel)
print "${updated.value}; revision=${updated.revision}; ${join (signalDependencies counterLabel, ",")}"