Unbound.LocallyNameless.Fresh

The Fresh and LFresh classes, which govern monads with fresh name generation capabilities, and the FreshM(T) and LFreshM(T) monad (transformers) which provide useful default implementations.

The Fresh class

class Monad m => Fresh m where

Type class for monads which can generate new globally unique Names based on a given Name.

Methods

fresh :: Name a -> m (Name a)

Instances

Fresh m => Fresh (ListT m)

Fresh m => Fresh (MaybeT m)

Fresh m => Fresh (IdentityT m)

Monad m => Fresh (FreshMT m)

Fresh m => Fresh (ContT r m)

(Error e, Fresh m) => Fresh (ErrorT e m)

Fresh m => Fresh (ReaderT r m)

Fresh m => Fresh (StateT s m)

Fresh m => Fresh (StateT s m)

(Monoid w, Fresh m) => Fresh (WriterT w m)

(Monoid w, Fresh m) => Fresh (WriterT w m)

type FreshM = FreshMT Identity

A convenient monad which is an instance of Fresh. It keeps track of a global index used for generating fresh names, which is incremented every time fresh is called.

runFreshM :: FreshM a -> a

Run a FreshM computation in an empty context.

contFreshM :: FreshM a -> Integer -> a

Run a FreshM computation given a starting index.

newtype FreshMT m a

The FreshM monad transformer. Keeps track of the lowest index still globally unused, and increments the index every time it is asked for a fresh name.

Constructors

FreshMT

Fields

unFreshMT :: StateT Integer m a

Instances

MonadTrans FreshMT

MonadError e m => MonadError e (FreshMT m)

MonadReader r m => MonadReader r (FreshMT m)

Monad m => MonadState Integer (FreshMT m)

MonadState s m => MonadState s (FreshMT m)

Monad m => Monad (FreshMT m)

Functor m => Functor (FreshMT m)

MonadPlus m => MonadPlus (FreshMT m)

(Monad m, Functor m) => Applicative (FreshMT m)

MonadIO m => MonadIO (FreshMT m)

MonadCont m => MonadCont (FreshMT m)

Monad m => Fresh (FreshMT m)

runFreshMT :: Monad m => FreshMT m a -> m a

Run a FreshMT computation starting in an empty context.

contFreshMT :: Monad m => FreshMT m a -> Integer -> m a

Run a FreshMT computation given a starting index for fresh name generation.

The LFresh class

class Monad m => LFresh m where

This is the class of monads that support freshness in an (implicit) local scope. Generated names are fresh for the current local scope, but not globally fresh.

Methods

lfresh :: Rep a => Name a -> m (Name a)

Pick a new name that is fresh for the current (implicit) scope.

avoid :: [AnyName] -> m a -> m a

Avoid the given names when freshening in the subcomputation.

Instances

LFresh m => LFresh (ListT m)

LFresh (Reader Integer)

A simple reader monad instance for LFresh.

LFresh m => LFresh (MaybeT m)

LFresh m => LFresh (IdentityT m)

Monad m => LFresh (LFreshMT m)

LFresh m => LFresh (ContT r m)

(Error e, LFresh m) => LFresh (ErrorT e m)

LFresh m => LFresh (ReaderT r m)

LFresh m => LFresh (StateT s m)

LFresh m => LFresh (StateT s m)

(Monoid w, LFresh m) => LFresh (WriterT w m)

(Monoid w, LFresh m) => LFresh (WriterT w m)

type LFreshM = LFreshMT Identity

A convenient monad which is an instance of LFresh. It keeps track of a set of names to avoid, and when asked for a fresh one will choose the first unused numerical name.

runLFreshM :: LFreshM a -> a

Run a LFreshM computation in an empty context.

contLFreshM :: LFreshM a -> Set AnyName -> a

Run a LFreshM computation given a set of names to avoid.

getAvoids :: Monad m => LFreshMT m (Set AnyName)

Get the set of names currently being avoided.

newtype LFreshMT m a

The LFresh monad transformer. Keeps track of a set of names to avoid, and when asked for a fresh one will choose the first unused numerical name.

Constructors

LFreshMT

Fields

unLFreshMT :: ReaderT (Set AnyName) m a

Instances

MonadTrans LFreshMT

MonadError e m => MonadError e (LFreshMT m)

MonadReader r m => MonadReader r (LFreshMT m)

MonadState s m => MonadState s (LFreshMT m)

Monad m => Monad (LFreshMT m)

Functor m => Functor (LFreshMT m)

MonadPlus m => MonadPlus (LFreshMT m)

Applicative m => Applicative (LFreshMT m)

MonadIO m => MonadIO (LFreshMT m)

MonadCont m => MonadCont (LFreshMT m)

Monad m => LFresh (LFreshMT m)

Monad m => MonadReader (Set AnyName) (LFreshMT m)

runLFreshMT :: LFreshMT m a -> m a

Run an LFreshMT computation in an empty context.

contLFreshMT :: LFreshMT m a -> Set AnyName -> m a

Run an LFreshMT computation given a set of names to avoid.