reactive-0.5: Simple foundation for functional reactive programmingSource codeContentsIndex

A future value is a value that will become knowable only later. This module gives a way to manipulate them functionally. For instance, a+b becomes knowable when the later of a and b becomes knowable. See

Primitive futures can be things like /the value of the next key you press, or the value of LambdaPix stock at noon next Monday/.

Composition is via standard type classes: Functor, Applicative, Monad, and Monoid. Some comments on the Future instances of these classes:

  • Monoid: mempty is a future that never becomes knowable. a mappend b is whichever of a and b is knowable first.
  • Functor: apply a function to a future. The result is knowable when the given future is knowable.
  • Applicative: pure gives value knowable since the beginning of time. '(<*>)' applies a future function to a future argument. Result available when both are available, i.e., it becomes knowable when the later of the two futures becomes knowable.
  • Monad: return is the same as pure (as always). (>>=) cascades futures. join resolves a future future into a future.

The current implementation is nondeterministic in mappend for futures that become knowable at the same time or nearly the same time. I want to make a deterministic implementation.

See Data.SFuture for a simple denotational semantics of futures. The current implementation does not quite implement this target semantics for mappend when futures are available simultaneously or nearly simultaneously. I'm still noodling how to implement that semantics.

data Future a
= Future (IO a)
| Never
force :: Future a -> IO a
newFuture :: IO (Future a, a -> IO ())
future :: IO a -> Future a
runFuture :: Future (IO ()) -> IO ()
data Future a Source
Value available in the future.
Future (IO a)Future that may arrive. The IO blocks until available. No side-effect.
NeverFuture that never arrives.
show/hide Instances
force :: Future a -> IO aSource
Access a future value. Blocks until available.
newFuture :: IO (Future a, a -> IO ())Source
Make a Future and a way to fill it. The filler should be invoked only once.
future :: IO a -> Future aSource
Make a Future, given a way to compute a value.
runFuture :: Future (IO ()) -> IO ()Source
Run an IO-action-valued Future.
Produced by Haddock version 2.3.0