MonadLib

This library provides a collection of monad transformers that can be combined to produce various monads.

Types

The following types define the representations of the computation types supported by the library. Each type adds support for a different effect.

data Id a

Computations with no effects.

Instances

MonadFix Id

Defined in MonadLib

Methods

mfix :: (a -> Id a) -> Id a

Applicative Id

Defined in MonadLib

Methods

pure :: a -> Id a

(<*>) :: Id (a -> b) -> Id a -> Id b

liftA2 :: (a -> b -> c) -> Id a -> Id b -> Id c

(*>) :: Id a -> Id b -> Id b

(<*) :: Id a -> Id b -> Id a

Functor Id

Defined in MonadLib

Methods

fmap :: (a -> b) -> Id a -> Id b

(<$) :: a -> Id b -> Id a

Monad Id

Defined in MonadLib

Methods

(>>=) :: Id a -> (a -> Id b) -> Id b

(>>) :: Id a -> Id b -> Id b

return :: a -> Id a

BaseM Id Id

Defined in MonadLib

Methods

inBase :: Id a -> Id a

RunM Id a a

Defined in MonadLib

Methods

runM :: Id a -> a

data Lift a

Computation with no effects (strict).

Instances

MonadFix Lift

Defined in MonadLib

Methods

mfix :: (a -> Lift a) -> Lift a

Applicative Lift

Defined in MonadLib

Methods

pure :: a -> Lift a

(<*>) :: Lift (a -> b) -> Lift a -> Lift b

liftA2 :: (a -> b -> c) -> Lift a -> Lift b -> Lift c

(*>) :: Lift a -> Lift b -> Lift b

(<*) :: Lift a -> Lift b -> Lift a

Functor Lift

Defined in MonadLib

Methods

fmap :: (a -> b) -> Lift a -> Lift b

(<$) :: a -> Lift b -> Lift a

Monad Lift

Defined in MonadLib

Methods

(>>=) :: Lift a -> (a -> Lift b) -> Lift b

(>>) :: Lift a -> Lift b -> Lift b

return :: a -> Lift a

BaseM Lift Lift

Defined in MonadLib

Methods

inBase :: Lift a -> Lift a

RunM Lift a a

Defined in MonadLib

Methods

runM :: Lift a -> a

data IdT m a

Adds no new features. Useful as a placeholder.

Instances

MonadT IdT

Defined in MonadLib

Methods

lift :: Monad m => m a -> IdT m a

MonadFail m => MonadFail (IdT m)

Defined in MonadLib

Methods

fail :: String -> IdT m a

MonadFix m => MonadFix (IdT m)

Defined in MonadLib

Methods

mfix :: (a -> IdT m a) -> IdT m a

MonadPlus m => Alternative (IdT m)

Defined in MonadLib

Methods

empty :: IdT m a

(<|>) :: IdT m a -> IdT m a -> IdT m a

some :: IdT m a -> IdT m [a]

many :: IdT m a -> IdT m [a]

Monad m => Applicative (IdT m)

Defined in MonadLib

Methods

pure :: a -> IdT m a

(<*>) :: IdT m (a -> b) -> IdT m a -> IdT m b

liftA2 :: (a -> b -> c) -> IdT m a -> IdT m b -> IdT m c

(*>) :: IdT m a -> IdT m b -> IdT m b

(<*) :: IdT m a -> IdT m b -> IdT m a

Monad m => Functor (IdT m)

Defined in MonadLib

Methods

fmap :: (a -> b) -> IdT m a -> IdT m b

(<$) :: a -> IdT m b -> IdT m a

Monad m => Monad (IdT m)

Defined in MonadLib

Methods

(>>=) :: IdT m a -> (a -> IdT m b) -> IdT m b

(>>) :: IdT m a -> IdT m b -> IdT m b

return :: a -> IdT m a

MonadPlus m => MonadPlus (IdT m)

Defined in MonadLib

Methods

mzero :: IdT m a

mplus :: IdT m a -> IdT m a -> IdT m a

ContM m => ContM (IdT m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (IdT m)) -> IdT m a) -> IdT m a

AbortM m i => AbortM (IdT m) i

Defined in MonadLib

Methods

abort :: i -> IdT m a

BaseM m n => BaseM (IdT m) n

Defined in MonadLib

Methods

inBase :: n a -> IdT m a

ExceptionM m j => ExceptionM (IdT m) j

Defined in MonadLib

Methods

raise :: j -> IdT m a

ReaderM m j => ReaderM (IdT m) j

Defined in MonadLib

Methods

ask :: IdT m j

RunExceptionM m i => RunExceptionM (IdT m) i

Defined in MonadLib

Methods

try :: IdT m a -> IdT m (Either i a)

RunReaderM m j => RunReaderM (IdT m) j

Defined in MonadLib

Methods

local :: j -> IdT m a -> IdT m a

RunWriterM m j => RunWriterM (IdT m) j

Defined in MonadLib

Methods

collect :: IdT m a -> IdT m (a, j)

StateM m j => StateM (IdT m) j

Defined in MonadLib

Methods

get :: IdT m j

set :: j -> IdT m ()

WriterM m j => WriterM (IdT m) j

Defined in MonadLib

Methods

put :: j -> IdT m ()

RunM m a r => RunM (IdT m) a r

Defined in MonadLib

Methods

runM :: IdT m a -> r

data ReaderT i m a

Add support for propagating a context of type i.

Instances

MonadT (ReaderT i)

Defined in MonadLib

Methods

lift :: Monad m => m a -> ReaderT i m a

MonadFail m => MonadFail (ReaderT i m)

Defined in MonadLib

Methods

fail :: String -> ReaderT i m a

MonadFix m => MonadFix (ReaderT i m)

Defined in MonadLib

Methods

mfix :: (a -> ReaderT i m a) -> ReaderT i m a

MonadPlus m => Alternative (ReaderT i m)

Defined in MonadLib

Methods

empty :: ReaderT i m a

(<|>) :: ReaderT i m a -> ReaderT i m a -> ReaderT i m a

some :: ReaderT i m a -> ReaderT i m [a]

many :: ReaderT i m a -> ReaderT i m [a]

Monad m => Applicative (ReaderT i m)

Defined in MonadLib

Methods

pure :: a -> ReaderT i m a

(<*>) :: ReaderT i m (a -> b) -> ReaderT i m a -> ReaderT i m b

liftA2 :: (a -> b -> c) -> ReaderT i m a -> ReaderT i m b -> ReaderT i m c

(*>) :: ReaderT i m a -> ReaderT i m b -> ReaderT i m b

(<*) :: ReaderT i m a -> ReaderT i m b -> ReaderT i m a

Monad m => Functor (ReaderT i m)

Defined in MonadLib

Methods

fmap :: (a -> b) -> ReaderT i m a -> ReaderT i m b

(<$) :: a -> ReaderT i m b -> ReaderT i m a

Monad m => Monad (ReaderT i m)

Defined in MonadLib

Methods

(>>=) :: ReaderT i m a -> (a -> ReaderT i m b) -> ReaderT i m b

(>>) :: ReaderT i m a -> ReaderT i m b -> ReaderT i m b

return :: a -> ReaderT i m a

MonadPlus m => MonadPlus (ReaderT i m)

Defined in MonadLib

Methods

mzero :: ReaderT i m a

mplus :: ReaderT i m a -> ReaderT i m a -> ReaderT i m a

ContM m => ContM (ReaderT i m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (ReaderT i m)) -> ReaderT i m a) -> ReaderT i m a

AbortM m i => AbortM (ReaderT j m) i

Defined in MonadLib

Methods

abort :: i -> ReaderT j m a

BaseM m n => BaseM (ReaderT i m) n

Defined in MonadLib

Methods

inBase :: n a -> ReaderT i m a

ExceptionM m j => ExceptionM (ReaderT i m) j

Defined in MonadLib

Methods

raise :: j -> ReaderT i m a

Monad m => ReaderM (ReaderT i m) i

Defined in MonadLib

Methods

ask :: ReaderT i m i

RunExceptionM m i => RunExceptionM (ReaderT j m) i

Defined in MonadLib

Methods

try :: ReaderT j m a -> ReaderT j m (Either i a)

Monad m => RunReaderM (ReaderT i m) i

Defined in MonadLib

Methods

local :: i -> ReaderT i m a -> ReaderT i m a

RunWriterM m j => RunWriterM (ReaderT i m) j

Defined in MonadLib

Methods

collect :: ReaderT i m a -> ReaderT i m (a, j)

StateM m j => StateM (ReaderT i m) j

Defined in MonadLib

Methods

get :: ReaderT i m j

set :: j -> ReaderT i m ()

WriterM m j => WriterM (ReaderT i m) j

Defined in MonadLib

Methods

put :: j -> ReaderT i m ()

RunM m a r => RunM (ReaderT i m) a (i -> r)

Defined in MonadLib

Methods

runM :: ReaderT i m a -> i -> r

data WriterT i m a

Add support for collecting values of type i. The type i should be a monoid, whose unit is used to represent a lack of a value, and whose binary operation is used to combine multiple values. This transformer is strict in its output component.

Instances

Monoid i => MonadT (WriterT i)

Defined in MonadLib

Methods

lift :: Monad m => m a -> WriterT i m a

(Monoid i, MonadFail m) => MonadFail (WriterT i m)

Defined in MonadLib

Methods

fail :: String -> WriterT i m a

(MonadFix m, Monoid i) => MonadFix (WriterT i m)

Defined in MonadLib

Methods

mfix :: (a -> WriterT i m a) -> WriterT i m a

(MonadPlus m, Monoid i) => Alternative (WriterT i m)

Defined in MonadLib

Methods

empty :: WriterT i m a

(<|>) :: WriterT i m a -> WriterT i m a -> WriterT i m a

some :: WriterT i m a -> WriterT i m [a]

many :: WriterT i m a -> WriterT i m [a]

(Monad m, Monoid i) => Applicative (WriterT i m)

Defined in MonadLib

Methods

pure :: a -> WriterT i m a

(<*>) :: WriterT i m (a -> b) -> WriterT i m a -> WriterT i m b

liftA2 :: (a -> b -> c) -> WriterT i m a -> WriterT i m b -> WriterT i m c

(*>) :: WriterT i m a -> WriterT i m b -> WriterT i m b

(<*) :: WriterT i m a -> WriterT i m b -> WriterT i m a

(Monad m, Monoid i) => Functor (WriterT i m)

Defined in MonadLib

Methods

fmap :: (a -> b) -> WriterT i m a -> WriterT i m b

(<$) :: a -> WriterT i m b -> WriterT i m a

(Monad m, Monoid i) => Monad (WriterT i m)

Defined in MonadLib

Methods

(>>=) :: WriterT i m a -> (a -> WriterT i m b) -> WriterT i m b

(>>) :: WriterT i m a -> WriterT i m b -> WriterT i m b

return :: a -> WriterT i m a

(MonadPlus m, Monoid i) => MonadPlus (WriterT i m)

Defined in MonadLib

Methods

mzero :: WriterT i m a

mplus :: WriterT i m a -> WriterT i m a -> WriterT i m a

(ContM m, Monoid i) => ContM (WriterT i m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (WriterT i m)) -> WriterT i m a) -> WriterT i m a

(AbortM m i, Monoid j) => AbortM (WriterT j m) i

Defined in MonadLib

Methods

abort :: i -> WriterT j m a

(BaseM m n, Monoid i) => BaseM (WriterT i m) n

Defined in MonadLib

Methods

inBase :: n a -> WriterT i m a

(ExceptionM m j, Monoid i) => ExceptionM (WriterT i m) j

Defined in MonadLib

Methods

raise :: j -> WriterT i m a

(ReaderM m j, Monoid i) => ReaderM (WriterT i m) j

Defined in MonadLib

Methods

ask :: WriterT i m j

(RunExceptionM m i, Monoid j) => RunExceptionM (WriterT j m) i

Defined in MonadLib

Methods

try :: WriterT j m a -> WriterT j m (Either i a)

(RunReaderM m j, Monoid i) => RunReaderM (WriterT i m) j

Defined in MonadLib

Methods

local :: j -> WriterT i m a -> WriterT i m a

(Monad m, Monoid i) => RunWriterM (WriterT i m) i

Defined in MonadLib

Methods

collect :: WriterT i m a -> WriterT i m (a, i)

(StateM m j, Monoid i) => StateM (WriterT i m) j

Defined in MonadLib

Methods

get :: WriterT i m j

set :: j -> WriterT i m ()

(Monad m, Monoid i) => WriterM (WriterT i m) i

Defined in MonadLib

Methods

put :: i -> WriterT i m ()

(Monoid i, RunM m (a, i) r) => RunM (WriterT i m) a r

Defined in MonadLib

Methods

runM :: WriterT i m a -> r

data StateT i m a

Add support for threading state of type i.

Instances

MonadT (StateT i)

Defined in MonadLib

Methods

lift :: Monad m => m a -> StateT i m a

MonadFail m => MonadFail (StateT i m)

Defined in MonadLib

Methods

fail :: String -> StateT i m a

MonadFix m => MonadFix (StateT i m)

Defined in MonadLib

Methods

mfix :: (a -> StateT i m a) -> StateT i m a

MonadPlus m => Alternative (StateT i m)

Defined in MonadLib

Methods

empty :: StateT i m a

(<|>) :: StateT i m a -> StateT i m a -> StateT i m a

some :: StateT i m a -> StateT i m [a]

many :: StateT i m a -> StateT i m [a]

Monad m => Applicative (StateT i m)

Defined in MonadLib

Methods

pure :: a -> StateT i m a

(<*>) :: StateT i m (a -> b) -> StateT i m a -> StateT i m b

liftA2 :: (a -> b -> c) -> StateT i m a -> StateT i m b -> StateT i m c

(*>) :: StateT i m a -> StateT i m b -> StateT i m b

(<*) :: StateT i m a -> StateT i m b -> StateT i m a

Monad m => Functor (StateT i m)

Defined in MonadLib

Methods

fmap :: (a -> b) -> StateT i m a -> StateT i m b

(<$) :: a -> StateT i m b -> StateT i m a

Monad m => Monad (StateT i m)

Defined in MonadLib

Methods

(>>=) :: StateT i m a -> (a -> StateT i m b) -> StateT i m b

(>>) :: StateT i m a -> StateT i m b -> StateT i m b

return :: a -> StateT i m a

MonadPlus m => MonadPlus (StateT i m)

Defined in MonadLib

Methods

mzero :: StateT i m a

mplus :: StateT i m a -> StateT i m a -> StateT i m a

ContM m => ContM (StateT i m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (StateT i m)) -> StateT i m a) -> StateT i m a

AbortM m i => AbortM (StateT j m) i

Defined in MonadLib

Methods

abort :: i -> StateT j m a

BaseM m n => BaseM (StateT i m) n

Defined in MonadLib

Methods

inBase :: n a -> StateT i m a

ExceptionM m j => ExceptionM (StateT i m) j

Defined in MonadLib

Methods

raise :: j -> StateT i m a

ReaderM m j => ReaderM (StateT i m) j

Defined in MonadLib

Methods

ask :: StateT i m j

RunExceptionM m i => RunExceptionM (StateT j m) i

Defined in MonadLib

Methods

try :: StateT j m a -> StateT j m (Either i a)

RunReaderM m j => RunReaderM (StateT i m) j

Defined in MonadLib

Methods

local :: j -> StateT i m a -> StateT i m a

RunWriterM m j => RunWriterM (StateT i m) j

Defined in MonadLib

Methods

collect :: StateT i m a -> StateT i m (a, j)

Monad m => StateM (StateT i m) i

Defined in MonadLib

Methods

get :: StateT i m i

set :: i -> StateT i m ()

WriterM m j => WriterM (StateT i m) j

Defined in MonadLib

Methods

put :: j -> StateT i m ()

RunM m (a, i) r => RunM (StateT i m) a (i -> r)

Defined in MonadLib

Methods

runM :: StateT i m a -> i -> r

data ExceptionT i m a

Add support for exceptions of type i.

Instances

MonadT (ExceptionT i)

Defined in MonadLib

Methods

lift :: Monad m => m a -> ExceptionT i m a

MonadFail m => MonadFail (ExceptionT i m)

Defined in MonadLib

Methods

fail :: String -> ExceptionT i m a

MonadFix m => MonadFix (ExceptionT i m)

Defined in MonadLib

Methods

mfix :: (a -> ExceptionT i m a) -> ExceptionT i m a

MonadPlus m => Alternative (ExceptionT i m)

Defined in MonadLib

Methods

empty :: ExceptionT i m a

(<|>) :: ExceptionT i m a -> ExceptionT i m a -> ExceptionT i m a

some :: ExceptionT i m a -> ExceptionT i m [a]

many :: ExceptionT i m a -> ExceptionT i m [a]

Monad m => Applicative (ExceptionT i m)

Defined in MonadLib

Methods

pure :: a -> ExceptionT i m a

(<*>) :: ExceptionT i m (a -> b) -> ExceptionT i m a -> ExceptionT i m b

liftA2 :: (a -> b -> c) -> ExceptionT i m a -> ExceptionT i m b -> ExceptionT i m c

(*>) :: ExceptionT i m a -> ExceptionT i m b -> ExceptionT i m b

(<*) :: ExceptionT i m a -> ExceptionT i m b -> ExceptionT i m a

Monad m => Functor (ExceptionT i m)

Defined in MonadLib

Methods

fmap :: (a -> b) -> ExceptionT i m a -> ExceptionT i m b

(<$) :: a -> ExceptionT i m b -> ExceptionT i m a

Monad m => Monad (ExceptionT i m)

Defined in MonadLib

Methods

(>>=) :: ExceptionT i m a -> (a -> ExceptionT i m b) -> ExceptionT i m b

(>>) :: ExceptionT i m a -> ExceptionT i m b -> ExceptionT i m b

return :: a -> ExceptionT i m a

MonadPlus m => MonadPlus (ExceptionT i m)

Defined in MonadLib

Methods

mzero :: ExceptionT i m a

mplus :: ExceptionT i m a -> ExceptionT i m a -> ExceptionT i m a

ContM m => ContM (ExceptionT i m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (ExceptionT i m)) -> ExceptionT i m a) -> ExceptionT i m a

AbortM m i => AbortM (ExceptionT j m) i

Defined in MonadLib

Methods

abort :: i -> ExceptionT j m a

BaseM m n => BaseM (ExceptionT i m) n

Defined in MonadLib

Methods

inBase :: n a -> ExceptionT i m a

Monad m => ExceptionM (ExceptionT i m) i

Defined in MonadLib

Methods

raise :: i -> ExceptionT i m a

ReaderM m j => ReaderM (ExceptionT i m) j

Defined in MonadLib

Methods

ask :: ExceptionT i m j

Monad m => RunExceptionM (ExceptionT i m) i

Defined in MonadLib

Methods

try :: ExceptionT i m a -> ExceptionT i m (Either i a)

RunReaderM m j => RunReaderM (ExceptionT i m) j

Defined in MonadLib

Methods

local :: j -> ExceptionT i m a -> ExceptionT i m a

RunWriterM m j => RunWriterM (ExceptionT i m) j

Defined in MonadLib

Methods

collect :: ExceptionT i m a -> ExceptionT i m (a, j)

StateM m j => StateM (ExceptionT i m) j

Defined in MonadLib

Methods

get :: ExceptionT i m j

set :: j -> ExceptionT i m ()

WriterM m j => WriterM (ExceptionT i m) j

Defined in MonadLib

Methods

put :: j -> ExceptionT i m ()

RunM m (Either i a) r => RunM (ExceptionT i m) a r

Defined in MonadLib

Methods

runM :: ExceptionT i m a -> r

About the WriterM instance: If an exception is risen while we are collecting output, then the output is lost. If the output is important, then use try to ensure that no exception may occur. Example:

do (r,w) <- collect (try m)
   case r of
     Left err -> ...do something...
     Right a  -> ...do something...

data ChoiceT m a

Add support for multiple answers.

Instances

MonadT ChoiceT

Defined in MonadLib

Methods

lift :: Monad m => m a -> ChoiceT m a

MonadFail m => MonadFail (ChoiceT m)

Defined in MonadLib

Methods

fail :: String -> ChoiceT m a

Monad m => Alternative (ChoiceT m)

Defined in MonadLib

Methods

empty :: ChoiceT m a

(<|>) :: ChoiceT m a -> ChoiceT m a -> ChoiceT m a

some :: ChoiceT m a -> ChoiceT m [a]

many :: ChoiceT m a -> ChoiceT m [a]

Monad m => Applicative (ChoiceT m)

Defined in MonadLib

Methods

pure :: a -> ChoiceT m a

(<*>) :: ChoiceT m (a -> b) -> ChoiceT m a -> ChoiceT m b

liftA2 :: (a -> b -> c) -> ChoiceT m a -> ChoiceT m b -> ChoiceT m c

(*>) :: ChoiceT m a -> ChoiceT m b -> ChoiceT m b

(<*) :: ChoiceT m a -> ChoiceT m b -> ChoiceT m a

Monad m => Functor (ChoiceT m)

Defined in MonadLib

Methods

fmap :: (a -> b) -> ChoiceT m a -> ChoiceT m b

(<$) :: a -> ChoiceT m b -> ChoiceT m a

Monad m => Monad (ChoiceT m)

Defined in MonadLib

Methods

(>>=) :: ChoiceT m a -> (a -> ChoiceT m b) -> ChoiceT m b

(>>) :: ChoiceT m a -> ChoiceT m b -> ChoiceT m b

return :: a -> ChoiceT m a

Monad m => MonadPlus (ChoiceT m)

Defined in MonadLib

Methods

mzero :: ChoiceT m a

mplus :: ChoiceT m a -> ChoiceT m a -> ChoiceT m a

ContM m => ContM (ChoiceT m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (ChoiceT m)) -> ChoiceT m a) -> ChoiceT m a

AbortM m i => AbortM (ChoiceT m) i

Defined in MonadLib

Methods

abort :: i -> ChoiceT m a

BaseM m n => BaseM (ChoiceT m) n

Defined in MonadLib

Methods

inBase :: n a -> ChoiceT m a

ExceptionM m j => ExceptionM (ChoiceT m) j

Defined in MonadLib

Methods

raise :: j -> ChoiceT m a

ReaderM m j => ReaderM (ChoiceT m) j

Defined in MonadLib

Methods

ask :: ChoiceT m j

StateM m j => StateM (ChoiceT m) j

Defined in MonadLib

Methods

get :: ChoiceT m j

set :: j -> ChoiceT m ()

WriterM m j => WriterM (ChoiceT m) j

Defined in MonadLib

Methods

put :: j -> ChoiceT m ()

RunM m (Maybe (a, ChoiceT m a)) r => RunM (ChoiceT m) a r

Defined in MonadLib

Methods

runM :: ChoiceT m a -> r

data ContT i m a

Add support for continuations within a prompt of type i.

Instances

MonadT (ContT i)

Defined in MonadLib

Methods

lift :: Monad m => m a -> ContT i m a

MonadFail m => MonadFail (ContT i m)

Defined in MonadLib

Methods

fail :: String -> ContT i m a

MonadPlus m => Alternative (ContT i m)

Defined in MonadLib

Methods

empty :: ContT i m a

(<|>) :: ContT i m a -> ContT i m a -> ContT i m a

some :: ContT i m a -> ContT i m [a]

many :: ContT i m a -> ContT i m [a]

Monad m => Applicative (ContT i m)

Defined in MonadLib

Methods

pure :: a -> ContT i m a

(<*>) :: ContT i m (a -> b) -> ContT i m a -> ContT i m b

liftA2 :: (a -> b -> c) -> ContT i m a -> ContT i m b -> ContT i m c

(*>) :: ContT i m a -> ContT i m b -> ContT i m b

(<*) :: ContT i m a -> ContT i m b -> ContT i m a

Monad m => Functor (ContT i m)

Defined in MonadLib

Methods

fmap :: (a -> b) -> ContT i m a -> ContT i m b

(<$) :: a -> ContT i m b -> ContT i m a

Monad m => Monad (ContT i m)

Defined in MonadLib

Methods

(>>=) :: ContT i m a -> (a -> ContT i m b) -> ContT i m b

(>>) :: ContT i m a -> ContT i m b -> ContT i m b

return :: a -> ContT i m a

MonadPlus m => MonadPlus (ContT i m)

Defined in MonadLib

Methods

mzero :: ContT i m a

mplus :: ContT i m a -> ContT i m a -> ContT i m a

Monad m => ContM (ContT i m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (ContT i m)) -> ContT i m a) -> ContT i m a

Monad m => AbortM (ContT i m) i

Defined in MonadLib

Methods

abort :: i -> ContT i m a

BaseM m n => BaseM (ContT i m) n

Defined in MonadLib

Methods

inBase :: n a -> ContT i m a

ExceptionM m j => ExceptionM (ContT i m) j

Defined in MonadLib

Methods

raise :: j -> ContT i m a

ReaderM m j => ReaderM (ContT i m) j

Defined in MonadLib

Methods

ask :: ContT i m j

RunReaderM m j => RunReaderM (ContT i m) j

Defined in MonadLib

Methods

local :: j -> ContT i m a -> ContT i m a

(RunWriterM m j, MonadFix m) => RunWriterM (ContT i m) j

Defined in MonadLib

Methods

collect :: ContT i m a -> ContT i m (a, j)

StateM m j => StateM (ContT i m) j

Defined in MonadLib

Methods

get :: ContT i m j

set :: j -> ContT i m ()

WriterM m j => WriterM (ContT i m) j

Defined in MonadLib

Methods

put :: j -> ContT i m ()

RunM m i r => RunM (ContT i m) a ((a -> m i) -> r)

Defined in MonadLib

Methods

runM :: ContT i m a -> (a -> m i) -> r

Lifting

The following operations allow us to promote computations in the underlying monad to computations that support an extra effect. Computations defined in this way do not make use of the new effect but can be combined with other operations that utilize the effect.

class MonadT t where

Methods

lift :: Monad m => m a -> t m a

Promote a computation from the underlying monad.

Instances

MonadT ChoiceT

Defined in MonadLib

Methods

lift :: Monad m => m a -> ChoiceT m a

MonadT IdT

Defined in MonadLib

Methods

lift :: Monad m => m a -> IdT m a

MonadT (ContT i)

Defined in MonadLib

Methods

lift :: Monad m => m a -> ContT i m a

MonadT (ExceptionT i)

Defined in MonadLib

Methods

lift :: Monad m => m a -> ExceptionT i m a

MonadT (ReaderT i)

Defined in MonadLib

Methods

lift :: Monad m => m a -> ReaderT i m a

MonadT (StateT i)

Defined in MonadLib

Methods

lift :: Monad m => m a -> StateT i m a

Monoid i => MonadT (WriterT i)

Defined in MonadLib

Methods

lift :: Monad m => m a -> WriterT i m a

class (Monad m, Monad n) => BaseM m n | m -> n where

Methods

inBase :: n a -> m a

Promote a computation from the base monad.

Instances

BaseM IO IO

Defined in MonadLib

Methods

inBase :: IO a -> IO a

BaseM Id Id

Defined in MonadLib

Methods

inBase :: Id a -> Id a

BaseM Lift Lift

Defined in MonadLib

Methods

inBase :: Lift a -> Lift a

BaseM Maybe Maybe

Defined in MonadLib

Methods

inBase :: Maybe a -> Maybe a

BaseM List List

Defined in MonadLib

Methods

inBase :: [a] -> [a]

BaseM m n => BaseM (ChoiceT m) n

Defined in MonadLib

Methods

inBase :: n a -> ChoiceT m a

BaseM m n => BaseM (IdT m) n

Defined in MonadLib

Methods

inBase :: n a -> IdT m a

BaseM (ST s) (ST s)

Defined in MonadLib

Methods

inBase :: ST s a -> ST s a

BaseM (Cont i) (Cont i)

Defined in MonadLib.Monads

Methods

inBase :: Cont i a -> Cont i a

BaseM (Exception i) (Exception i)

Defined in MonadLib.Monads

Methods

inBase :: Exception i a -> Exception i a

BaseM (Reader i) (Reader i)

Defined in MonadLib.Monads

Methods

inBase :: Reader i a -> Reader i a

BaseM (State i) (State i)

Defined in MonadLib.Monads

Methods

inBase :: State i a -> State i a

Monoid i => BaseM (Writer i) (Writer i)

Defined in MonadLib.Monads

Methods

inBase :: Writer i a -> Writer i a

BaseM m n => BaseM (ContT i m) n

Defined in MonadLib

Methods

inBase :: n a -> ContT i m a

BaseM m n => BaseM (ExceptionT i m) n

Defined in MonadLib

Methods

inBase :: n a -> ExceptionT i m a

BaseM m n => BaseM (ReaderT i m) n

Defined in MonadLib

Methods

inBase :: n a -> ReaderT i m a

BaseM m n => BaseM (StateT i m) n

Defined in MonadLib

Methods

inBase :: n a -> StateT i m a

(BaseM m n, Monoid i) => BaseM (WriterT i m) n

Defined in MonadLib

Methods

inBase :: n a -> WriterT i m a

Effect Classes

The following classes define overloaded operations that can be used to define effectful computations.

class Monad m => ReaderM m i | m -> i where

Classifies monads that provide access to a context of type i.

Methods

ask :: m i

Get the context.

Instances

ReaderM m j => ReaderM (ChoiceT m) j

Defined in MonadLib

Methods

ask :: ChoiceT m j

ReaderM m j => ReaderM (IdT m) j

Defined in MonadLib

Methods

ask :: IdT m j

ReaderM (Reader i) i

Defined in MonadLib.Monads

Methods

ask :: Reader i i

ReaderM m j => ReaderM (ContT i m) j

Defined in MonadLib

Methods

ask :: ContT i m j

ReaderM m j => ReaderM (ExceptionT i m) j

Defined in MonadLib

Methods

ask :: ExceptionT i m j

Monad m => ReaderM (ReaderT i m) i

Defined in MonadLib

Methods

ask :: ReaderT i m i

ReaderM m j => ReaderM (StateT i m) j

Defined in MonadLib

Methods

ask :: StateT i m j

(ReaderM m j, Monoid i) => ReaderM (WriterT i m) j

Defined in MonadLib

Methods

ask :: WriterT i m j

class Monad m => WriterM m i | m -> i where

Classifies monads that can collect values of type i.

Methods

put :: i -> m ()

Add a value to the collection.

Instances

WriterM m j => WriterM (ChoiceT m) j

Defined in MonadLib

Methods

put :: j -> ChoiceT m ()

WriterM m j => WriterM (IdT m) j

Defined in MonadLib

Methods

put :: j -> IdT m ()

Monoid i => WriterM (Writer i) i

Defined in MonadLib.Monads

Methods

put :: i -> Writer i ()

WriterM m j => WriterM (ContT i m) j

Defined in MonadLib

Methods

put :: j -> ContT i m ()

WriterM m j => WriterM (ExceptionT i m) j

Defined in MonadLib

Methods

put :: j -> ExceptionT i m ()

WriterM m j => WriterM (ReaderT i m) j

Defined in MonadLib

Methods

put :: j -> ReaderT i m ()

WriterM m j => WriterM (StateT i m) j

Defined in MonadLib

Methods

put :: j -> StateT i m ()

(Monad m, Monoid i) => WriterM (WriterT i m) i

Defined in MonadLib

Methods

put :: i -> WriterT i m ()

class Monad m => StateM m i | m -> i where

Classifies monads that propagate a state component of type i.

Methods

get :: m i

Get the state.

set :: i -> m ()

Set the state.

Instances

StateM m j => StateM (ChoiceT m) j

Defined in MonadLib

Methods

get :: ChoiceT m j

set :: j -> ChoiceT m ()

StateM m j => StateM (IdT m) j

Defined in MonadLib

Methods

get :: IdT m j

set :: j -> IdT m ()

StateM (State i) i

Defined in MonadLib.Monads

Methods

get :: State i i

set :: i -> State i ()

StateM m j => StateM (ContT i m) j

Defined in MonadLib

Methods

get :: ContT i m j

set :: j -> ContT i m ()

StateM m j => StateM (ExceptionT i m) j

Defined in MonadLib

Methods

get :: ExceptionT i m j

set :: j -> ExceptionT i m ()

StateM m j => StateM (ReaderT i m) j

Defined in MonadLib

Methods

get :: ReaderT i m j

set :: j -> ReaderT i m ()

Monad m => StateM (StateT i m) i

Defined in MonadLib

Methods

get :: StateT i m i

set :: i -> StateT i m ()

(StateM m j, Monoid i) => StateM (WriterT i m) j

Defined in MonadLib

Methods

get :: WriterT i m j

set :: j -> WriterT i m ()

class Monad m => ExceptionM m i | m -> i where

Classifies monads that support raising exceptions of type i.

Methods

raise :: i -> m a

Raise an exception.

Instances

ExceptionM IO SomeException

Defined in MonadLib

Methods

raise :: SomeException -> IO a

ExceptionM m j => ExceptionM (ChoiceT m) j

Defined in MonadLib

Methods

raise :: j -> ChoiceT m a

ExceptionM m j => ExceptionM (IdT m) j

Defined in MonadLib

Methods

raise :: j -> IdT m a

ExceptionM (Exception i) i

Defined in MonadLib.Monads

Methods

raise :: i -> Exception i a

ExceptionM m j => ExceptionM (ContT i m) j

Defined in MonadLib

Methods

raise :: j -> ContT i m a

Monad m => ExceptionM (ExceptionT i m) i

Defined in MonadLib

Methods

raise :: i -> ExceptionT i m a

ExceptionM m j => ExceptionM (ReaderT i m) j

Defined in MonadLib

Methods

raise :: j -> ReaderT i m a

ExceptionM m j => ExceptionM (StateT i m) j

Defined in MonadLib

Methods

raise :: j -> StateT i m a

(ExceptionM m j, Monoid i) => ExceptionM (WriterT i m) j

Defined in MonadLib

Methods

raise :: j -> WriterT i m a

class Monad m => ContM m where

Classifies monads that provide access to a computation's continuation.

Methods

callWithCC :: ((a -> Label m) -> m a) -> m a

Capture the current continuation.

Instances

ContM m => ContM (ChoiceT m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (ChoiceT m)) -> ChoiceT m a) -> ChoiceT m a

ContM m => ContM (IdT m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (IdT m)) -> IdT m a) -> IdT m a

ContM (Cont i)

Defined in MonadLib.Monads

Methods

callWithCC :: ((a -> Label (Cont i)) -> Cont i a) -> Cont i a

Monad m => ContM (ContT i m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (ContT i m)) -> ContT i m a) -> ContT i m a

ContM m => ContM (ExceptionT i m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (ExceptionT i m)) -> ExceptionT i m a) -> ExceptionT i m a

ContM m => ContM (ReaderT i m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (ReaderT i m)) -> ReaderT i m a) -> ReaderT i m a

ContM m => ContM (StateT i m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (StateT i m)) -> StateT i m a) -> StateT i m a

(ContM m, Monoid i) => ContM (WriterT i m)

Defined in MonadLib

Methods

callWithCC :: ((a -> Label (WriterT i m)) -> WriterT i m a) -> WriterT i m a

class Monad m => AbortM m i where

Classifies monads that support aborting the program and returning a given final result of type i.

Methods

abort :: i -> m a

Abort the program with the given value as final result.

Instances

AbortM IO ExitCode

Defined in MonadLib

Methods

abort :: ExitCode -> IO a

AbortM m i => AbortM (ChoiceT m) i

Defined in MonadLib

Methods

abort :: i -> ChoiceT m a

AbortM m i => AbortM (IdT m) i

Defined in MonadLib

Methods

abort :: i -> IdT m a

Monad m => AbortM (ContT i m) i

Defined in MonadLib

Methods

abort :: i -> ContT i m a

AbortM m i => AbortM (ExceptionT j m) i

Defined in MonadLib

Methods

abort :: i -> ExceptionT j m a

AbortM m i => AbortM (ReaderT j m) i

Defined in MonadLib

Methods

abort :: i -> ReaderT j m a

AbortM m i => AbortM (StateT j m) i

Defined in MonadLib

Methods

abort :: i -> StateT j m a

(AbortM m i, Monoid j) => AbortM (WriterT j m) i

Defined in MonadLib

Methods

abort :: i -> WriterT j m a

data Label m

An explicit representation for monadic continuations.

labelCC :: ContM m => a -> m (a, a -> Label m)

Capture the current continuation. This function is like return, except that it also captures the current continuation. Later, we can use jump to repeat the computation from this point onwards but with a possibly different value.

labelCC_ :: forall m. ContM m => m (Label m)

Capture the current continuation. Later we can use jump to restart the program from this point.

jump :: Label m -> m a

Restart a previously captured computation.

labelC :: (forall b. m b) -> Label m

Label a given continuation.

callCC :: ContM m => ((a -> m b) -> m a) -> m a

A version of callWithCC that avoids the need for an explicit use of the jump function.

Execution

Eliminating Effects

The following functions eliminate the outermost effect of a computation by translating a computation into an equivalent computation in the underlying monad. (The exceptions are Id and Lift which are not transformers but ordinary monads and so, their run operations simply eliminate the monad.)

runId :: Id a -> a

Get the result of a pure computation.

runLift :: Lift a -> a

Get the result of a pure strict computation.

runIdT :: IdT m a -> m a

Remove an identity layer.

runReaderT :: i -> ReaderT i m a -> m a

Execute a reader computation in the given context.

runWriterT :: Monad m => WriterT i m a -> m (a, i)

Execute a writer computation. Returns the result and the collected output.

runStateT :: i -> StateT i m a -> m (a, i)

Execute a stateful computation in the given initial state. The second component of the result is the final state.

runExceptionT :: ExceptionT i m a -> m (Either i a)

Execute a computation with exceptions. Successful results are tagged with Right, exceptional results are tagged with Left.

runContT :: (a -> m i) -> ContT i m a -> m i

Execute a computation with the given continuation.

runChoiceT :: Monad m => ChoiceT m a -> m (Maybe (a, ChoiceT m a))

Execute a computation that may return multiple answers. The resulting computation returns Nothing if no answers were found, or Just (answer,new_comp), where answer is an answer, and new_comp is a computation that may produce more answers. The search is depth-first and left-biased with respect to the mplus operation.

findOne :: Monad m => ChoiceT m a -> m (Maybe a)

Execute a computation that may return multiple answers, returning at most one answer.

findAll :: Monad m => ChoiceT m a -> m [a]

Execute a computation that may return multiple answers, collecting all possible answers.

class Monad m => RunM m a r | m a -> r where

Generalized running.

Methods

runM :: m a -> r

Instances

RunM Id a a

Defined in MonadLib

Methods

runM :: Id a -> a

RunM Lift a a

Defined in MonadLib

Methods

runM :: Lift a -> a

RunM IO a (IO a)

Defined in MonadLib

Methods

runM :: IO a -> IO a

RunM m (Maybe (a, ChoiceT m a)) r => RunM (ChoiceT m) a r

Defined in MonadLib

Methods

runM :: ChoiceT m a -> r

RunM m a r => RunM (IdT m) a r

Defined in MonadLib

Methods

runM :: IdT m a -> r

RunM m (Either i a) r => RunM (ExceptionT i m) a r

Defined in MonadLib

Methods

runM :: ExceptionT i m a -> r

(Monoid i, RunM m (a, i) r) => RunM (WriterT i m) a r

Defined in MonadLib

Methods

runM :: WriterT i m a -> r

RunM m i r => RunM (ContT i m) a ((a -> m i) -> r)

Defined in MonadLib

Methods

runM :: ContT i m a -> (a -> m i) -> r

RunM m a r => RunM (ReaderT i m) a (i -> r)

Defined in MonadLib

Methods

runM :: ReaderT i m a -> i -> r

RunM m (a, i) r => RunM (StateT i m) a (i -> r)

Defined in MonadLib

Methods

runM :: StateT i m a -> i -> r

Nested Execution

The following classes define operations that are overloaded versions of the run operations. Unlike the run operations, these functions do not change the type of the computation (i.e., they do not remove a layer). Instead, they perform the effects in a ``separate effect thread''.

class ReaderM m i => RunReaderM m i | m -> i where

Classifies monads that support changing the context for a sub-computation.

Methods

local :: i -> m a -> m a

Change the context for the duration of a sub-computation.

Instances

RunReaderM m j => RunReaderM (IdT m) j

Defined in MonadLib

Methods

local :: j -> IdT m a -> IdT m a

RunReaderM (Reader i) i

Defined in MonadLib.Monads

Methods

local :: i -> Reader i a -> Reader i a

RunReaderM m j => RunReaderM (ContT i m) j

Defined in MonadLib

Methods

local :: j -> ContT i m a -> ContT i m a

RunReaderM m j => RunReaderM (ExceptionT i m) j

Defined in MonadLib

Methods

local :: j -> ExceptionT i m a -> ExceptionT i m a

Monad m => RunReaderM (ReaderT i m) i

Defined in MonadLib

Methods

local :: i -> ReaderT i m a -> ReaderT i m a

RunReaderM m j => RunReaderM (StateT i m) j

Defined in MonadLib

Methods

local :: j -> StateT i m a -> StateT i m a

(RunReaderM m j, Monoid i) => RunReaderM (WriterT i m) j

Defined in MonadLib

Methods

local :: j -> WriterT i m a -> WriterT i m a

class WriterM m i => RunWriterM m i | m -> i where

Classifies monads that support collecting the output of a sub-computation.

Methods

collect :: m a -> m (a, i)

Collect the output from a sub-computation.

Instances

RunWriterM m j => RunWriterM (IdT m) j

Defined in MonadLib

Methods

collect :: IdT m a -> IdT m (a, j)

Monoid i => RunWriterM (Writer i) i

Defined in MonadLib.Monads

Methods

collect :: Writer i a -> Writer i (a, i)

(RunWriterM m j, MonadFix m) => RunWriterM (ContT i m) j

Defined in MonadLib

Methods

collect :: ContT i m a -> ContT i m (a, j)

RunWriterM m j => RunWriterM (ExceptionT i m) j

Defined in MonadLib

Methods

collect :: ExceptionT i m a -> ExceptionT i m (a, j)

RunWriterM m j => RunWriterM (ReaderT i m) j

Defined in MonadLib

Methods

collect :: ReaderT i m a -> ReaderT i m (a, j)

RunWriterM m j => RunWriterM (StateT i m) j

Defined in MonadLib

Methods

collect :: StateT i m a -> StateT i m (a, j)

(Monad m, Monoid i) => RunWriterM (WriterT i m) i

Defined in MonadLib

Methods

collect :: WriterT i m a -> WriterT i m (a, i)

class ExceptionM m i => RunExceptionM m i | m -> i where

Classifies monads that support handling of exceptions.

Methods

try :: m a -> m (Either i a)

Convert computations that may raise an exception into computations that do not raise exception but instead, yield a tagged results. Exceptions are tagged with Left, successful computations are tagged with Right.

Instances

RunExceptionM IO SomeException

Defined in MonadLib

Methods

try :: IO a -> IO (Either SomeException a)

RunExceptionM m i => RunExceptionM (IdT m) i

Defined in MonadLib

Methods

try :: IdT m a -> IdT m (Either i a)

RunExceptionM (Exception i) i

Defined in MonadLib.Monads

Methods

try :: Exception i a -> Exception i (Either i a)

Monad m => RunExceptionM (ExceptionT i m) i

Defined in MonadLib

Methods

try :: ExceptionT i m a -> ExceptionT i m (Either i a)

RunExceptionM m i => RunExceptionM (ReaderT j m) i

Defined in MonadLib

Methods

try :: ReaderT j m a -> ReaderT j m (Either i a)

RunExceptionM m i => RunExceptionM (StateT j m) i

Defined in MonadLib

Methods

try :: StateT j m a -> StateT j m (Either i a)

(RunExceptionM m i, Monoid j) => RunExceptionM (WriterT j m) i

Defined in MonadLib

Methods

try :: WriterT j m a -> WriterT j m (Either i a)

Utility functions

asks :: ReaderM m r => (r -> a) -> m a

Apply a function to the environment. Useful for accessing environmnt components.

puts :: WriterM m w => (a, w) -> m a

Add content the output and return a result.

sets :: StateM m s => (s -> (a, s)) -> m a

Update the state and return a result.

sets_ :: StateM m s => (s -> s) -> m ()

Updates the state with the given function.

raises :: ExceptionM m x => Either x a -> m a

Either raise an exception or return a value. Left values signify the we should raise an exception, Right values indicate success.

mapReader :: RunReaderM m r => (r -> r) -> m a -> m a

Modify the environment for the duration of a computation.

mapWriter :: RunWriterM m w => (w -> w) -> m a -> m a

Modify the output of a computation.

mapException :: RunExceptionM m x => (x -> x) -> m a -> m a

Modify the exception that was risen by a computation.

handle :: RunExceptionM m x => m a -> (x -> m a) -> m a

Apply the given exception handler, if a computation raises an exception.

type family WithBase base layers :: Type -> Type where ...

A convenience type family for defining stacks of monads. The first entry in the list is the top-most layer of the monad stack (i.e., the one that is furtherest from the base). For example:

newtype M a = M { unM ::
  WithBase IO
    '[ ReaderT    Int
     , StateT     Char
     , ExceptionT String
     ] a
  }

is equivalent to:

newtype M a = M { unM ::
  ReaderT    Int      (
  StateT     Char     (
  ExceptionT String
  IO                  )) a
  }

Equations

WithBase b '[] = b

WithBase b (f ': fs) = f (WithBase b fs)

module Control.Monad