elabTerm for Tactics and basic tactics that use it.

def Lean.Elab.Tactic.runTermElab {α : Type} (k : Lean.Elab.TermElabM α) (mayPostpone : Bool := false) : Lean.Elab.Tactic.TacticM α

Runs a term elaborator inside a tactic.

This function ensures that term elaboration fails when backtracking, i.e., in first| tac term | other.

def Lean.Elab.Tactic.runTermElab.go {α : Type} (k : Lean.Elab.TermElabM α) (mayPostpone : Bool := false) : Lean.Elab.TermElabM α

def Lean.Elab.Tactic.elabTerm (stx : Lean.Syntax) (expectedType? : Option Lean.Expr) (mayPostpone : Bool := false) : Lean.Elab.Tactic.TacticM Lean.Expr

Elaborate stx in the current MVarContext. If given, the expectedType will be used to help elaboration but not enforced (use elabTermEnsuringType to enforce an expected type).

def Lean.Elab.Tactic.elabTermEnsuringType (stx : Lean.Syntax) (expectedType? : Option Lean.Expr) (mayPostpone : Bool := false) : Lean.Elab.Tactic.TacticM Lean.Expr

Elaborate stx in the current MVarContext. If given, the expectedType will be used to help elaboration and then a TypeMismatchError will be thrown if the elaborated type doesn't match.

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.logUnassignedAndAbort (mvarIds : Array Lean.MVarId) : Lean.Elab.Tactic.TacticM Unit

def Lean.Elab.Tactic.filterOldMVars (mvarIds : Array Lean.MVarId) (mvarCounterSaved : Nat) : Lean.MetaM (Array Lean.MVarId)

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.closeMainGoalUsing (tacName : Lean.Name) (x : Lean.Expr → Lean.Name → Lean.Elab.Tactic.TacticM Lean.Expr) (checkNewUnassigned : Bool := true) : Lean.Elab.Tactic.TacticM Unit

Try to close main goal using x target tag, where target is the type of the main goal and tag is its user name.

If checkNewUnassigned is true, then throws an error if the resulting value has metavariables that were created during the execution of x. If it is false, then it is the responsibility of x to add such metavariables to the goal list.

During the execution of x:

• The local context is that of the main goal.
• The goal list has the main goal removed.
• It is allowable to modify the goal list, for example with Lean.Elab.Tactic.pushGoals.

On failure, the main goal remains at the front of the goal list.

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.evalExact : Lean.Elab.Tactic.Tactic

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.sortMVarIdArrayByIndex {m : Type → Type} [Lean.MonadMCtx m] [Monad m] (mvarIds : Array Lean.MVarId) : m (Array Lean.MVarId)

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.sortMVarIdsByIndex {m : Type → Type} [Lean.MonadMCtx m] [Monad m] (mvarIds : List Lean.MVarId) : m (List Lean.MVarId)

Equations

• Lean.Elab.Tactic.sortMVarIdsByIndex mvarIds = do let __do_lift ← Lean.Elab.Tactic.sortMVarIdArrayByIndex mvarIds.toArray pure __do_lift.toList

def Lean.Elab.Tactic.withCollectingNewGoalsFrom (k : Lean.Elab.Tactic.TacticM Lean.Expr) (parentTag tagSuffix : Lean.Name) (allowNaturalHoles : Bool := false) : Lean.Elab.Tactic.TacticM (Lean.Expr × List Lean.MVarId)

Execute k, and collect new "holes" in the resulting expression.

• parentTag and tagSuffix are used to tag untagged goals with Lean.Elab.Tactic.tagUntaggedGoals.
• If allowNaturalHoles is true, then _'s are allowed and create new goals.

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.withCollectingNewGoalsFrom.go (k : Lean.Elab.Tactic.TacticM Lean.Expr) (parentTag tagSuffix : Lean.Name) (allowNaturalHoles : Bool := false) : Lean.Elab.Tactic.TacticM (Lean.Expr × List Lean.MVarId)

def Lean.Elab.Tactic.elabTermWithHoles (stx : Lean.Syntax) (expectedType? : Option Lean.Expr) (tagSuffix : Lean.Name) (allowNaturalHoles : Bool := false) (parentTag? : Option Lean.Name := none) : Lean.Elab.Tactic.TacticM (Lean.Expr × List Lean.MVarId)

Elaborates stx and collects the MVarIds of any holes that were created during elaboration.

With allowNaturalHoles := false (the default), any new natural holes (_) which cannot be synthesized during elaboration cause elabTermWithHoles to fail. (Natural goals appearing in stx which were created prior to elaboration are permitted.)

Unnamed MVarIds are renamed to share the tag parentTag? (or the main goal's tag if parentTag? is none). If multiple unnamed goals are encountered, tagSuffix is appended to this tag along with a numerical index.

Note:

• Previously-created MVarIds which appear in stx are not returned.
• All parts of elabTermWithHoles operate at the current MCtxDepth, and therefore may assign metavariables.
• When allowNaturalHoles := true, stx is elaborated under withAssignableSyntheticOpaque, meaning that .syntheticOpaque metavariables might be assigned during elaboration. This is a consequence of the implementation.

def Lean.Elab.Tactic.refineCore (stx : Lean.Syntax) (tagSuffix : Lean.Name) (allowNaturalHoles : Bool) : Lean.Elab.Tactic.TacticM Unit

If allowNaturalHoles == true, then we allow the resultant expression to contain unassigned "natural" metavariables. Recall that "natutal" metavariables are created for explicit holes _ and implicit arguments. They are meant to be filled by typing constraints. "Synthetic" metavariables are meant to be filled by tactics and are usually created using the synthetic hole notation ?<hole-name>.

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.evalRefine : Lean.Elab.Tactic.Tactic

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.evalRefine' : Lean.Elab.Tactic.Tactic

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.evalSpecialize : Lean.Elab.Tactic.Tactic

def Lean.Elab.Tactic.elabTermForApply (stx : Lean.Syntax) (mayPostpone : Bool := true) : Lean.Elab.Tactic.TacticM Lean.Expr

Given a tactic

apply f

we want the apply tactic to create all metavariables. The following definition will return @f for f. That is, it will not create metavariables for implicit arguments. A similar method is also used in Lean 3. This method is useful when applying lemmas such as:

theorem infLeRight {s t : Set α} : s ⊓ t ≤ t

where s ≤ t here is defined as

∀ {x : α}, x ∈ s → x ∈ t

def Lean.Elab.Tactic.getFVarId (id : Lean.Syntax) : Lean.Elab.Tactic.TacticM Lean.FVarId

def Lean.Elab.Tactic.getFVarIds (ids : Array Lean.Syntax) : Lean.Elab.Tactic.TacticM (Array Lean.FVarId)

Equations

• Lean.Elab.Tactic.getFVarIds ids = Lean.Elab.Tactic.withMainContext (Array.mapM Lean.Elab.Tactic.getFVarId ids)

def Lean.Elab.Tactic.evalApplyLikeTactic (tac : Lean.MVarId → Lean.Expr → Lean.MetaM (List Lean.MVarId)) (e : Lean.Syntax) : Lean.Elab.Tactic.TacticM Unit

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.evalApply : Lean.Elab.Tactic.Tactic

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.evalConstructor : Lean.Elab.Tactic.Tactic

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.evalWithReducible : Lean.Elab.Tactic.Tactic

Equations

• Lean.Elab.Tactic.evalWithReducible stx = Lean.Meta.withReducible (Lean.Elab.Tactic.evalTactic stx[1])

def Lean.Elab.Tactic.evalWithReducibleAndInstances : Lean.Elab.Tactic.Tactic

Equations

• Lean.Elab.Tactic.evalWithReducibleAndInstances stx = Lean.Meta.withReducibleAndInstances (Lean.Elab.Tactic.evalTactic stx[1])

def Lean.Elab.Tactic.evalWithUnfoldingAll : Lean.Elab.Tactic.Tactic

def Lean.Elab.Tactic.elabAsFVar (stx : Lean.Syntax) (userName? : Option Lean.Name := none) : Lean.Elab.Tactic.TacticM Lean.FVarId

Elaborate stx. If it is a free variable, return it. Otherwise, assert it, and return the free variable. Note that, the main goal is updated when Meta.assert is used in the second case.

def Lean.Elab.Tactic.evalRename : Lean.Elab.Tactic.Tactic

def Lean.Elab.Tactic.evalDecideCore (tacticName : Lean.Name) (cfg : Lean.Parser.Tactic.DecideConfig) : Lean.Elab.Tactic.TacticM Unit

def Lean.Elab.Tactic.evalDecideCore.doElab (tacticName : Lean.Name) (expectedType : Lean.Expr) : Lean.Elab.Tactic.TacticM Lean.Expr

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.evalDecideCore.doKernel (tacticName : Lean.Name) (expectedType : Lean.Expr) : Lean.Elab.Tactic.TacticM Lean.Expr

def Lean.Elab.Tactic.evalDecideCore.diagnose (tacticName : Lean.Name) {α : Type} (expectedType s : Lean.Expr) (r? : Option Lean.Expr) : Lean.Elab.Tactic.TacticM α

Equations

• One or more equations did not get rendered due to their size.

def Lean.Elab.Tactic.elabDecideConfig : Lean.Syntax → Lean.Elab.Tactic.TacticM Lean.Parser.Tactic.DecideConfig

def Lean.Elab.Tactic.evalDecide : Lean.Elab.Tactic.Tactic

def Lean.Elab.Tactic.evalNativeDecide : Lean.Elab.Tactic.Tactic

Equations

• One or more equations did not get rendered due to their size.