speculation-0.0.1: A framework for safe, programmable, speculative parallelism

Control.Concurrent.Speculation

Synopsis

# Documentation

spec :: Eq a => a -> (a -> b) -> a -> bSource

Evaluate a function using a cheap guess at the argument in parallel with forcing the argument.

This is one way to induce parallelism in an otherwise sequential task. If the argument has already been evaluated, we avoid sparking the parallel computation.

evaluated :: a -> BoolSource

Returns a guess as to whether or not a value has been evaluated. This is an impure function that relies on GHC internals and will return false negatives, but (hopefully) no false positives.

specFoldr :: (Speculative f, Eq b) => (Int -> b) -> (a -> b -> b) -> b -> f a -> bSource

Compute a right biased fold. The estimator function provides a guess at the value of the suffix

specFoldl :: (Speculative f, Eq b) => (Int -> b) -> (b -> a -> b) -> b -> f a -> bSource

Compute a left-biased fold. The estimator function provides a guess at the value of the prefix

class Foldable f => Speculative f whereSource

Methods

specFoldr1 :: Eq a => (Int -> a) -> (a -> a -> a) -> f a -> aSource

Compute a right-biased fold. The estimator function is a guess at the value of the prefix

specFoldrN :: Eq b => Int -> (Int -> b) -> (a -> b -> b) -> b -> f a -> bSource

specFoldl1 :: Eq a => (Int -> a) -> (a -> a -> a) -> f a -> aSource

Compute a left biased fold. the estimator function is a guess at the value of the prefix

specFoldlN :: Eq b => Int -> (Int -> b) -> (b -> a -> b) -> b -> f a -> bSource

Instances

 Speculative [] Speculative Maybe Speculative IntMap Speculative Set Speculative Seq Ix i => Speculative (Array i) Speculative (Map a) Foldable f => Speculative (WithoutSpeculation f) Foldable f => Speculative (WrappedFoldable f)

newtype WrappedFoldable f a Source

Constructors

 WrappedFoldable FieldsgetWrappedFoldable :: f a

Instances

 Functor f => Functor (WrappedFoldable f) Typeable1 f => Typeable1 (WrappedFoldable f) Foldable f => Foldable (WrappedFoldable f) Traversable f => Traversable (WrappedFoldable f) Foldable f => Speculative (WrappedFoldable f) (Typeable1 f, Data (f a), Data a) => Data (WrappedFoldable f a)

newtype WithoutSpeculation f a Source

Constructors

 WithoutSpeculation FieldsgetWithoutSpeculation :: f a

Instances

 Functor f => Functor (WithoutSpeculation f) Typeable1 f => Typeable1 (WithoutSpeculation f) Foldable f => Foldable (WithoutSpeculation f) Traversable f => Traversable (WithoutSpeculation f) Foldable f => Speculative (WithoutSpeculation f) (Typeable1 f, Data (f a), Data a) => Data (WithoutSpeculation f a)