ghc-8.2.2: The GHC API

Safe Haskell | None
Language | Haskell2010

CoreFVs

Contents

- Free variables of expressions and binding groups
- Selective free variables of expressions
- Free variables of Rules, Vars and Ids
- Orphan names
- Core syntax tree annotation with free variables

Description

A module concerned with finding the free variables of an expression.

Synopsis

- exprFreeVars :: CoreExpr -> VarSet
- exprFreeVarsDSet :: CoreExpr -> DVarSet
- exprFreeVarsList :: CoreExpr -> [Var]
- exprFreeIds :: CoreExpr -> IdSet
- exprFreeIdsDSet :: CoreExpr -> DIdSet
- exprFreeIdsList :: CoreExpr -> [Id]
- exprsFreeIdsDSet :: [CoreExpr] -> DIdSet
- exprsFreeIdsList :: [CoreExpr] -> [Id]
- exprsFreeVars :: [CoreExpr] -> VarSet
- exprsFreeVarsList :: [CoreExpr] -> [Var]
- bindFreeVars :: CoreBind -> VarSet
- type InterestingVarFun = Var -> Bool
- exprSomeFreeVars :: InterestingVarFun -> CoreExpr -> VarSet
- exprsSomeFreeVars :: InterestingVarFun -> [CoreExpr] -> VarSet
- exprSomeFreeVarsList :: InterestingVarFun -> CoreExpr -> [Var]
- exprsSomeFreeVarsList :: InterestingVarFun -> [CoreExpr] -> [Var]
- varTypeTyCoVars :: Var -> TyCoVarSet
- varTypeTyCoFVs :: Var -> FV
- idUnfoldingVars :: Id -> VarSet
- idFreeVars :: Id -> VarSet
- dIdFreeVars :: Id -> DVarSet
- bndrRuleAndUnfoldingVarsDSet :: Id -> DVarSet
- idFVs :: Id -> FV
- idRuleVars :: Id -> VarSet
- idRuleRhsVars :: (Activation -> Bool) -> Id -> VarSet
- stableUnfoldingVars :: Unfolding -> Maybe VarSet
- ruleRhsFreeVars :: CoreRule -> VarSet
- ruleFreeVars :: CoreRule -> VarSet
- rulesFreeVars :: [CoreRule] -> VarSet
- rulesFreeVarsDSet :: [CoreRule] -> DVarSet
- ruleLhsFreeIds :: CoreRule -> VarSet
- ruleLhsFreeIdsList :: CoreRule -> [Var]
- vectsFreeVars :: [CoreVect] -> VarSet
- expr_fvs :: CoreExpr -> FV
- orphNamesOfType :: Type -> NameSet
- orphNamesOfCo :: Coercion -> NameSet
- orphNamesOfAxiom :: CoAxiom br -> NameSet
- orphNamesOfTypes :: [Type] -> NameSet
- orphNamesOfCoCon :: CoAxiom br -> NameSet
- exprsOrphNames :: [CoreExpr] -> NameSet
- orphNamesOfFamInst :: FamInst -> NameSet
- data FVAnn
- type CoreExprWithFVs = AnnExpr Id FVAnn
- type CoreExprWithFVs' = AnnExpr' Id FVAnn
- type CoreBindWithFVs = AnnBind Id FVAnn
- type CoreAltWithFVs = AnnAlt Id FVAnn
- freeVars :: CoreExpr -> CoreExprWithFVs
- freeVarsBind :: CoreBind -> DVarSet -> (CoreBindWithFVs, DVarSet)
- freeVarsOf :: CoreExprWithFVs -> DIdSet
- freeVarsOfType :: CoreExprWithFVs -> DTyCoVarSet
- freeVarsOfAnn :: FVAnn -> DIdSet
- freeVarsOfTypeAnn :: FVAnn -> DTyCoVarSet
- exprTypeFV :: CoreExprWithFVs -> Type

# Free variables of expressions and binding groups

exprFreeVars :: CoreExpr -> VarSet #

Find all locally-defined free Ids or type variables in an expression returning a non-deterministic set.

exprFreeVarsDSet :: CoreExpr -> DVarSet #

Find all locally-defined free Ids or type variables in an expression returning a deterministic set.

exprFreeVarsList :: CoreExpr -> [Var] #

Find all locally-defined free Ids or type variables in an expression returning a deterministically ordered list.

exprFreeIds :: CoreExpr -> IdSet #

Find all locally-defined free Ids in an expression

exprFreeIdsDSet :: CoreExpr -> DIdSet #

Find all locally-defined free Ids in an expression returning a deterministic set.

exprFreeIdsList :: CoreExpr -> [Id] #

Find all locally-defined free Ids in an expression returning a deterministically ordered list.

exprsFreeIdsDSet :: [CoreExpr] -> DIdSet #

Find all locally-defined free Ids in several expressions returning a deterministic set.

exprsFreeIdsList :: [CoreExpr] -> [Id] #

Find all locally-defined free Ids in several expressions returning a deterministically ordered list.

exprsFreeVars :: [CoreExpr] -> VarSet #

Find all locally-defined free Ids or type variables in several expressions returning a non-deterministic set.

exprsFreeVarsList :: [CoreExpr] -> [Var] #

Find all locally-defined free Ids or type variables in several expressions returning a deterministically ordered list.

bindFreeVars :: CoreBind -> VarSet #

Find all locally defined free Ids in a binding group

# Selective free variables of expressions

type InterestingVarFun = Var -> Bool #

Predicate on possible free variables: returns `True` iff the variable is interesting

exprSomeFreeVars #

Arguments

:: InterestingVarFun | Says which `Var`s are interesting
-> CoreExpr |
-> VarSet |

Finds free variables in an expression selected by a predicate

exprsSomeFreeVars :: InterestingVarFun -> [CoreExpr] -> VarSet #

Finds free variables in several expressions selected by a predicate

exprSomeFreeVarsList #

Arguments

:: InterestingVarFun | Says which `Var`s are interesting
-> CoreExpr |
-> [Var] |

Finds free variables in an expression selected by a predicate returning a deterministically ordered list.

exprsSomeFreeVarsList :: InterestingVarFun -> [CoreExpr] -> [Var] #

Finds free variables in several expressions selected by a predicate returning a deterministically ordered list.

# Free variables of Rules, Vars and Ids

varTypeTyCoVars :: Var -> TyCoVarSet #

varTypeTyCoFVs :: Var -> FV #

idUnfoldingVars :: Id -> VarSet #

idFreeVars :: Id -> VarSet #

dIdFreeVars :: Id -> DVarSet #

bndrRuleAndUnfoldingVarsDSet :: Id -> DVarSet #

idFVs :: Id -> FV #

idRuleVars :: Id -> VarSet #

idRuleRhsVars :: (Activation -> Bool) -> Id -> VarSet #

stableUnfoldingVars :: Unfolding -> Maybe VarSet #

ruleRhsFreeVars :: CoreRule -> VarSet #

Those variables free in the right hand side of a rule returned as a non-deterministic set

ruleFreeVars :: CoreRule -> VarSet #

Those variables free in the both the left right hand sides of a rule returned as a non-deterministic set

rulesFreeVars :: [CoreRule] -> VarSet #

Those variables free in the right hand side of several rules

rulesFreeVarsDSet :: [CoreRule] -> DVarSet #

Those variables free in the both the left right hand sides of rules returned as a deterministic set

ruleLhsFreeIds :: CoreRule -> VarSet #

This finds all locally-defined free Ids on the left hand side of a rule and returns them as a non-deterministic set

ruleLhsFreeIdsList :: CoreRule -> [Var] #

This finds all locally-defined free Ids on the left hand side of a rule and returns them as a determinisitcally ordered list

vectsFreeVars :: [CoreVect] -> VarSet #

Free variables of a vectorisation declaration

expr_fvs :: CoreExpr -> FV #

# Orphan names

orphNamesOfType :: Type -> NameSet #

orphNamesOfCo :: Coercion -> NameSet #

orphNamesOfAxiom :: CoAxiom br -> NameSet #

orphNamesOfTypes :: [Type] -> NameSet #

orphNamesOfCoCon :: CoAxiom br -> NameSet #

exprsOrphNames :: [CoreExpr] -> NameSet #

Finds the free external names of several expressions: see `exprOrphNames` for details

orphNamesOfFamInst :: FamInst -> NameSet #

orphNamesOfAxiom collects the names of the concrete types and type constructors that make up the LHS of a type family instance, including the family name itself.

For instance, given `type family Foo a b`: `type instance Foo (F (G (H a))) b = ...` would yield [Foo,F,G,H]

Used in the implementation of ":info" in GHCi.

# Core syntax tree annotation with free variables

data FVAnn #

type CoreExprWithFVs = AnnExpr Id FVAnn #

Every node in an expression annotated with its (non-global) free variables, both Ids and TyVars, and type.

type CoreExprWithFVs' = AnnExpr' Id FVAnn #

type CoreBindWithFVs = AnnBind Id FVAnn #

Every node in a binding group annotated with its (non-global) free variables, both Ids and TyVars, and type.

type CoreAltWithFVs = AnnAlt Id FVAnn #

Every node in an expression annotated with its (non-global) free variables, both Ids and TyVars, and type.

freeVars :: CoreExpr -> CoreExprWithFVs #

Annotate a `CoreExpr` with its (non-global) free type and value variables at every tree node

freeVarsBind :: CoreBind -> DVarSet -> (CoreBindWithFVs, DVarSet) #

freeVarsOf :: CoreExprWithFVs -> DIdSet #

Inverse function to `freeVars`

freeVarsOfType :: CoreExprWithFVs -> DTyCoVarSet #

Extract the vars free in an annotated expression's type

freeVarsOfAnn :: FVAnn -> DIdSet #

Extract the vars reported in a FVAnn

freeVarsOfTypeAnn :: FVAnn -> DTyCoVarSet #

Extract the type-level vars reported in a FVAnn

exprTypeFV :: CoreExprWithFVs -> Type #

Extract the type of an annotated expression. (This is cheap.)