{-# LANGUAGE DeriveFunctor, ExplicitForAll, FlexibleContexts, FlexibleInstances, KindSignatures, MultiParamTypeClasses, TypeOperators, UndecidableInstances #-} module Control.Effect.State.Internal ( State(..) , get , gets , put , modify , modifyLazy ) where import Control.Effect.Carrier import Control.Effect.Sum import Data.Coerce import Prelude hiding (fail) data State s (m :: * -> *) k = Get (s -> k) | Put s k deriving (Functor) instance HFunctor (State s) where hmap _ = coerce {-# INLINE hmap #-} instance Effect (State s) where handle state handler (Get k) = Get (handler . (<$ state) . k) handle state handler (Put s k) = Put s (handler . (<$ state) $ k) -- | Get the current state value. -- -- prop> snd (run (runState a get)) == a get :: (Member (State s) sig, Carrier sig m) => m s get = send (Get pure) -- | Project a function out of the current state value. -- -- prop> snd (run (runState a (gets (applyFun f)))) == applyFun f a gets :: (Member (State s) sig, Carrier sig m) => (s -> a) -> m a gets f = send (Get (pure . f)) -- | Replace the state value with a new value. -- -- prop> fst (run (runState a (put b))) == b -- prop> snd (run (runState a (get <* put b))) == a -- prop> snd (run (runState a (put b *> get))) == b put :: (Member (State s) sig, Carrier sig m) => s -> m () put s = send (Put s (pure ())) -- | Replace the state value with the result of applying a function to the current state value. -- This is strict in the new state. -- -- prop> fst (run (runState a (modify (+1)))) == (1 + a :: Integer) modify :: (Member (State s) sig, Carrier sig m) => (s -> s) -> m () modify f = do a <- get put $! f a -- | Replace the state value with the result of applying a function to the current state value. -- This is lazy in the new state; injudicious use of this function may lead to space leaks. modifyLazy :: (Member (State s) sig, Carrier sig m) => (s -> s) -> m () modifyLazy f = get >>= put . f -- $setup -- >>> :seti -XFlexibleContexts -- >>> import Test.QuickCheck -- >>> import Control.Effect.Pure -- >>> import Control.Effect.State.Strict