Safe Haskell | None |
---|
Control flow and monadic utilities.
Synopsis
- while :: Monad.Monad m => m Bool -> m a -> m [a]
- while_ :: Monad.Monad m => m Bool -> m a -> m ()
- mconcatMap :: Monoid b => (a -> b) -> [a] -> b
- concatMapM :: (Monad.Monad m, Monoid b) => (a -> m b) -> [a] -> m b
- justm :: Monad.Monad m => m (Maybe a) -> (a -> m (Maybe b)) -> m (Maybe b)
- rightm :: Monad.Monad m => m (Either err a) -> (a -> m (Either err b)) -> m (Either err b)
- firstJust :: Monad.Monad m => m (Maybe a) -> m (Maybe a) -> m (Maybe a)
- firstJusts :: Monad.Monad m => [m (Maybe a)] -> m (Maybe a)
- justErr :: err -> Maybe a -> Either err a
- tryJust :: MonadError e m => e -> Maybe a -> m a
- tryRight :: MonadError e m => Either e a -> m a
- rethrow :: MonadError e m => (e -> e) -> m a -> m a
- class Bifunctor (p :: * -> * -> *) where
- findM :: Monad.Monad m => (a -> m Bool) -> [a] -> m (Maybe a)
- andM :: Monad.Monad m => [m Bool] -> m Bool
- orM :: Monad.Monad m => [m Bool] -> m Bool
- allM :: Monad.Monad m => (a -> m Bool) -> [a] -> m Bool
- anyM :: Monad.Monad m => (a -> m Bool) -> [a] -> m Bool
- notM :: Functor m => m Bool -> m Bool
- ifM :: Monad.Monad m => m Bool -> m a -> m a -> m a
- unlessM :: Monad.Monad m => m Bool -> m () -> m ()
- whenM :: Monad.Monad m => m Bool -> m () -> m ()
- mapMaybeM :: Monad.Monad m => (a -> m (Maybe b)) -> [a] -> m [b]
- whenJustM :: Monad.Monad m => m (Maybe a) -> (a -> m ()) -> m ()
- whenJust :: Applicative m => Maybe a -> (a -> m ()) -> m ()
- errorStack :: Stack => Text -> a
- errorIO :: Stack => MonadIO m => Text -> m a
Documentation
while :: Monad.Monad m => m Bool -> m a -> m [a] Source #
while_ :: Monad.Monad m => m Bool -> m a -> m () Source #
mconcatMap :: Monoid b => (a -> b) -> [a] -> b Source #
This is foldMap
specialized to lists.
concatMapM :: (Monad.Monad m, Monoid b) => (a -> m b) -> [a] -> m b Source #
This is actually a mconcatMapM.
A further generalized version would be:
foldMapA :: (Applicative f, Traversable t, Monoid m) => (a -> f m) -> t a -> f m foldMapA f = fmap Foldable.fold . traverse f
justm :: Monad.Monad m => m (Maybe a) -> (a -> m (Maybe b)) -> m (Maybe b) Source #
Run the second action only if the first action returns Just.
This is like MaybeT, but using MaybeT itself required lots of annoying explicit lifting.
rightm :: Monad.Monad m => m (Either err a) -> (a -> m (Either err b)) -> m (Either err b) Source #
The Either equivalent of justm
. EitherT solves the same problem, but
requires a runEitherT and lots of hoistEithers.
firstJust :: Monad.Monad m => m (Maybe a) -> m (Maybe a) -> m (Maybe a) Source #
Return the first action to return Just.
firstJusts :: Monad.Monad m => [m (Maybe a)] -> m (Maybe a) Source #
firstJust
applied to a list.
tryJust :: MonadError e m => e -> Maybe a -> m a Source #
I usually call this require
.
tryRight :: MonadError e m => Either e a -> m a Source #
I usually call this require_right
.
rethrow :: MonadError e m => (e -> e) -> m a -> m a Source #
class Bifunctor (p :: * -> * -> *) where #
A bifunctor is a type constructor that takes
two type arguments and is a functor in both arguments. That
is, unlike with Functor
, a type constructor such as Either
does not need to be partially applied for a Bifunctor
instance, and the methods in this class permit mapping
functions over the Left
value or the Right
value,
or both at the same time.
Formally, the class Bifunctor
represents a bifunctor
from Hask
-> Hask
.
Intuitively it is a bifunctor where both the first and second arguments are covariant.
You can define a Bifunctor
by either defining bimap
or by
defining both first
and second
.
If you supply bimap
, you should ensure that:
bimap
id
id
≡id
If you supply first
and second
, ensure:
first
id
≡id
second
id
≡id
If you supply both, you should also ensure:
bimap
f g ≡first
f.
second
g
These ensure by parametricity:
bimap
(f.
g) (h.
i) ≡bimap
f h.
bimap
g ifirst
(f.
g) ≡first
f.
first
gsecond
(f.
g) ≡second
f.
second
g
Since: base-4.8.0.0
bimap :: (a -> b) -> (c -> d) -> p a c -> p b d #
Map over both arguments at the same time.
bimap
f g ≡first
f.
second
g
Examples
>>>
bimap toUpper (+1) ('j', 3)
('J',4)
>>>
bimap toUpper (+1) (Left 'j')
Left 'J'
>>>
bimap toUpper (+1) (Right 3)
Right 4
Instances
Bifunctor Either | Since: base-4.8.0.0 |
Bifunctor (,) | Since: base-4.8.0.0 |
Bifunctor Arg | Since: base-4.9.0.0 |
Bifunctor Of | |
Bifunctor ((,,) x1) | Since: base-4.8.0.0 |
Bifunctor (Const :: * -> * -> *) | Since: base-4.8.0.0 |
Bifunctor (Tagged :: * -> * -> *) | |
Bifunctor (K1 i :: * -> * -> *) | Since: base-4.9.0.0 |
Bifunctor ((,,,) x1 x2) | Since: base-4.8.0.0 |
Bifunctor ((,,,,) x1 x2 x3) | Since: base-4.8.0.0 |
Bifunctor ((,,,,,) x1 x2 x3 x4) | Since: base-4.8.0.0 |
Bifunctor ((,,,,,,) x1 x2 x3 x4 x5) | Since: base-4.8.0.0 |
findM :: Monad.Monad m => (a -> m Bool) -> [a] -> m (Maybe a) #
Like find
, but where the test can be monadic.
findM (Just . isUpper) "teST" == Just (Just 'S') findM (Just . isUpper) "test" == Just Nothing findM (Just . const True) ["x",undefined] == Just (Just "x")
andM :: Monad.Monad m => [m Bool] -> m Bool #
A version of and
lifted to a monad. Retains the short-circuiting behaviour.
andM [Just True,Just False,undefined] == Just False andM [Just True,Just True ,undefined] == undefined \xs -> Just (and xs) == andM (map Just xs)
orM :: Monad.Monad m => [m Bool] -> m Bool #
A version of or
lifted to a monad. Retains the short-circuiting behaviour.
orM [Just False,Just True ,undefined] == Just True orM [Just False,Just False,undefined] == undefined \xs -> Just (or xs) == orM (map Just xs)
allM :: Monad.Monad m => (a -> m Bool) -> [a] -> m Bool #
A version of all
lifted to a monad. Retains the short-circuiting behaviour.
allM Just [True,False,undefined] == Just False allM Just [True,True ,undefined] == undefined \(f :: Int -> Maybe Bool) xs -> anyM f xs == orM (map f xs)
anyM :: Monad.Monad m => (a -> m Bool) -> [a] -> m Bool #
A version of any
lifted to a monad. Retains the short-circuiting behaviour.
anyM Just [False,True ,undefined] == Just True anyM Just [False,False,undefined] == undefined \(f :: Int -> Maybe Bool) xs -> anyM f xs == orM (map f xs)
ifM :: Monad.Monad m => m Bool -> m a -> m a -> m a #
Like if
, but where the test can be monadic.
unlessM :: Monad.Monad m => m Bool -> m () -> m () #
Like unless
, but where the test can be monadic.
whenM :: Monad.Monad m => m Bool -> m () -> m () #
Like when
, but where the test can be monadic.
mapMaybeM :: Monad.Monad m => (a -> m (Maybe b)) -> [a] -> m [b] #
A version of mapMaybe
that works with a monadic predicate.
whenJustM :: Monad.Monad m => m (Maybe a) -> (a -> m ()) -> m () #
Like whenJust
, but where the test can be monadic.
whenJust :: Applicative m => Maybe a -> (a -> m ()) -> m () #