Control.Monad.Extra

Documentation

skip :: Monad m => m ()

Synonym for return ().

discard :: Monad m => a -> m ()

Discards a value

obvious :: Applicative f => f ()

Synonym for pure ().

bind :: Monad m => m a -> (a -> m b) -> m b

Function name for >>=, as fmap is to <$>.

om :: Monad m => (a -> b -> m c) -> m a -> b -> m c

Combinator for working with monadic values:

>>> om when (return True) $ print "Hello"
"Hello"
>>> return True >>= flip when (print "Hello")
"Hello"
>>> om forM_ (return [True]) print
True
>>> flip forM_ print =<< return [True]
True
>>> mapM_ print =<< return [True]
True

Subsumes the need for individual functions for whenM, unlessM, etc.

nom :: Monad m => (a -> b -> m c) -> a -> m b -> m c

Variant of om which changes the roles of the 2nd and 3rd arguments.

>>> nom mapM_ print $ return [True]
True
>>> mapM_ print =<< return [True]
True

doCallCC :: Monad m => ((r -> ContT r m b) -> ContT r m r) -> m r

Convenience function if all you want to use is callCC.

label :: ContT r m (ContT r m a)

Return a continuation that one can jump back to within ContT.

>>> flip runContT return $ do { k <- label; ...; k }

io :: MonadIO m => IO a -> m a

Short-hand for liftIO.

liftMaybe :: MonadPlus m => Maybe a -> m a

Lift a Maybe value into the MaybeT monad transformer.