{-# LANGUAGE CPP #-} module Control.Composition ( -- * Postcomposition (.*) , (.**) , (.***) , (.****) -- * Precomposition , (-.) , (-.*) , (-.**) , (-.***) , (-.****) -- * Fancy function application , (-$) -- * Composition with lists of functions , thread , threadM_ -- * Tuple helpers , both -- * Functor helpers , (<&>) -- * Reexports from base , (&) , fix , on , ap , bool ) where import Control.Arrow ((***)) import Control.Monad import Data.Bool (bool) #if __GLASGOW_HASKELL__ > 784 import Data.Function (fix, on, (&)) #else import Data.Function (fix, on) #endif #if defined(MIN_VERSION_lens) #if MIN_VERSION_lens(3,0) import Control.Lens ((<&>)) #endif #endif infixr 8 .* infixr 8 .** infixr 8 .*** infixr 8 .**** infixr 8 -.* infixr 8 -.** infixr 8 -.*** infixr 8 -.**** infixl 8 -$ #if __GLASGOW_HASKELL__ <= 784 infixl 1 & (&) :: a -> (a -> b) -> b (&) x f = f x #endif #if defined(MIN_VERSION_lens) #if !MIN_VERSION_lens(3,0) infixl 1 <&> #endif #else infixl 1 <&> #endif both :: (a -> b) -> (a, a) -> (b, b) both = join (***) -- | Backwards function (-$) :: (a -> b -> c) -> b -> a -> c (-$) f x y = f y x -- | As an example: -- -- > λ:> ((*2) .* (+)) 1 3 4 -- > 16 (.*) :: (c -> d) -> (a -> b -> c) -> a -> b -> d (.*) f g x y = f (g x y) (.**) :: (d -> e) -> (a -> b -> c -> d) -> a -> b -> c -> e (.**) f g x y z = f (g x y z) (.***) :: (e -> f) -> (a -> b -> c -> d -> e) -> a -> b -> c -> d -> f (.***) f g w x y z = f (g w x y z) (.****) :: (f -> g) -> (a -> b -> c -> d -> e -> f) -> a -> b -> c -> d -> e -> g (.****) f g v w x y z = f (g v w x y z) -- | The Oedipus combinator (-.*) :: (b -> c) -> (a -> c -> d) -> a -> b -> d (-.*) f g x y = g x (f y) (-.**) :: (c -> d) -> (a -> b -> d -> e) -> a -> b -> c -> e (-.**) f g x y z = g x y (f z) (-.***) :: (d -> e) -> (a -> b -> c -> e -> f) -> a -> b -> c -> d -> f (-.***) f g w x y z = g w x y (f z) (-.****) :: (e -> f) -> (a -> b -> c -> d -> f -> g) -> a -> b -> c -> d -> e -> g (-.****) f g v w x y z = g v w x y (f z) -- | Backwards function composition (-.) :: (a -> b) -> (b -> c) -> a -> c (-.) f g x = g (f x) #if defined(MIN_VERSION_lens) #if !MIN_VERSION_lens(3,0) (<&>) :: Functor f => f a -> (a -> b) -> f b x <&> f = fmap f x #endif #else (<&>) :: Functor f => f a -> (a -> b) -> f b x <&> f = fmap f x #endif -- (<$$) thread :: [a -> a] -> a -> a thread = foldr (.) id threadM_ :: (Applicative f) => [f ()] -> f () threadM_ = foldr (*>) (pure ()) -- setZip :: [ASetter a a b b] -> [b] -> a -> a -- setZip ls ts = thread (zipWith set ls ts)