Documentation

Lean.Elab.Match

Remark: if the discriminat is Syntax.missing, we abort the elaboration of the match-expression. This can happen due to error recovery. Example

example : (p ∨ p) → p := fun h => match

If we don't abort, the elaborator loops because we will keep trying to expand

match

into

let d := <Syntax.missing>; match

Recall that Syntax.setArg stx i arg is a no-op when i is out-of-bounds.

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

        We convert the collected PatternVars intro PatternVarDecl

        Instances For

          Remark: when performing dependent pattern matching, we often had to write code such as

          def Vec.map' (f : α → β) (xs : Vec α n) : Vec β n :=
            match n, xs with
            | _, nil       => nil
            | _, cons a as => cons (f a) (map' f as)
          

          We had to include n and the _s because the type of xs depends on n. Moreover, nil and cons a as have different types. This was quite tedious. So, we have implemented an automatic "discriminant refinement procedure". The procedure is based on the observation that we get a type error whenenver we forget to include _s and the indices a discriminant depends on. So, we catch the exception, check whether the type of the discriminant is an indexed family, and add their indices as new discriminants.

          The current implementation, adds indices as they are found, and does not try to "sort" the new discriminants.

          If the refinement process fails, we report the original error message.

          Auxiliary structure for storing an type mismatch exception when processing the pattern #idx of some alternative.

          Instances For
            • userName : Lean.Name

              When visiting an assigned metavariable, if it has an user-name. We save it here. We want to preserve these user-names when generating new pattern variables.

            • explicitPatternVars : Array Lean.FVarId

              Pattern variables that were explicitly provided by the user. Recall that implicit parameters and _ are elaborated as metavariables, and then converted into pattern variables by the normalize procedure.

            Instances For
              @[reducible, inline]
              Instances For

                Return true iff e is an explicit pattern variable provided by the user.

                Instances For

                  Normalize the pattern and collect all patterns variables (explicit and implicit). This method is the one that decides where the inaccessible annotations must be inserted. The pattern variables are both free variables (for explicit pattern variables) and metavariables (for implicit ones). Recall that mkLambdaFVars now allows us to abstract both free variables and metavariables.

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

                      Save pattern information in the info tree, and remove patternWithRef? annotations.

                      Equations
                      Instances For

                        The Bool context is true iff we are inside of an "inaccessible" pattern.

                        Main method for withDepElimPatterns.

                        • PatternVarDecls: are the explicit pattern variables provided by the user.
                        • ps: are the patterns provided by the user.
                        • matchType: the expected typ for this branch. It depends on the explicit pattern variables and the implicit ones that are still represented as metavariables, and are found by this function.
                        • k is the continuation that is executed in an updated local context with the all pattern variables (explicit and implicit). Note that, patternVarDecls are all replaced since they may depend on implicit pattern variables (i.e., metavariables) that are converted into new free variables by this method.
                        Equations
                        • One or more equations did not get rendered due to their size.
                        Instances For
                          Instances For
                            Equations
                            • One or more equations did not get rendered due to their size.
                            Instances For
                              Equations
                              Instances For
                                Equations
                                • One or more equations did not get rendered due to their size.
                                Instances For