# Library Cpdt.StackMachine

`StackMachine.v`for this chapter interactively in Proof General. Alternatively, to get a feel for the whole lifecycle of creating a Coq development, you can enter the pieces of source code in this chapter in a new

`.v`file in an Emacs buffer. If you do the latter, include these three lines at the start of the file.

Require Import Bool Arith List Cpdt.CpdtTactics.

Set Implicit Arguments.

Set Asymmetric Patterns.

In general, similar commands will be hidden in the book rendering of each chapter's source code, so you will need to insert them in from-scratch replayings of the code that is presented. To be more specific, every chapter begins with the above three lines, with the import list tweaked as appropriate, considering which definitions the chapter uses. The second command above affects the default behavior of definitions regarding type inference, and the third allows for more concise pattern-matching syntax in Coq versions 8.5 and higher (having no effect in earlier versions).
We will begin with that staple of compiler textbooks, arithmetic expressions over a single type of numbers.
We begin with the syntax of the source language.

# Arithmetic Expressions Over Natural Numbers

## Source Language

Our first line of Coq code should be unsurprising to ML and Haskell programmers. We define an algebraic datatype binop to stand for the binary operators of our source language. There are just two wrinkles compared to ML and Haskell. First, we use the keyword Inductive, in place of

`data`,`datatype`, or`type`. This is not just a trivial surface syntax difference; inductive types in Coq are much more expressive than garden variety algebraic datatypes, essentially enabling us to encode all of mathematics, though we begin humbly in this chapter. Second, there is the : Set fragment, which declares that we are defining a datatype that should be thought of as a constituent of programs. Later, we will see other options for defining datatypes in the universe of proofs or in an infinite hierarchy of universes, encompassing both programs and proofs, that is useful in higher-order constructions.
Now we define the type of arithmetic expressions. We write that a constant may be built from one argument, a natural number; and a binary operation may be built from a choice of operator and two operand expressions.
A note for readers following along in the PDF version: coqdoc supports pretty-printing of tokens in LaTeX or HTML. Where you see a right arrow character, the source contains the ASCII text
Now we are ready to say what programs in our expression language mean. We will do this by writing an interpreter that can be thought of as a trivial operational or denotational semantics. (If you are not familiar with these semantic techniques, no need to worry: we will stick to "common sense" constructions.)

`-`>. Other examples of this substitution appearing in this chapter are a double right arrow for`=`>, the inverted 'A' symbol for`forall`, and the Cartesian product 'X' for`*`. When in doubt about the ASCII version of a symbol, you can consult the chapter source code.Definition binopDenote (b : binop) : nat -> nat -> nat :=

match b with

| Plus => plus

| Times => mult

end.

The meaning of a binary operator is a binary function over naturals, defined with pattern-matching notation analogous to the

Definition binopDenote : binop -> nat -> nat -> nat := fun (b : binop) =>

match b with

| Plus => plus

| Times => mult

end.
In this example, we could also omit all of the type annotations, arriving at:

Definition binopDenote := fun b =>

match b with

| Plus => plus

| Times => mult

end.
Languages like Haskell and ML have a convenient
This is as good a time as any to mention the profusion of different languages associated with Coq. The theoretical foundation of Coq is a formal system called the
Coq is actually based on an extension of CIC called Gallina. The text after the := and before the period in the last code example is a term of Gallina. Gallina includes several useful features that must be considered as extensions to CIC. The important metatheorems about CIC have not been extended to the full breadth of the features that go beyond the formalized language, but most Coq users do not seem to lose much sleep over this omission.
Next, there is Ltac, Coq's domain-specific language for writing proofs and decision procedures. We will see some basic examples of Ltac later in this chapter, and much of this book is devoted to more involved Ltac examples.
Finally, commands like Inductive and Definition are part of the Vernacular, which includes all sorts of useful queries and requests to the Coq system. Every Coq source file is a series of vernacular commands, where many command forms take arguments that are Gallina or Ltac programs. (Actually, Coq source files are more like
We can give a simple definition of the meaning of an expression:

`case`and`match`of ML and Haskell, and referring to the functions plus and mult from the Coq standard library. The keyword Definition is Coq's all-purpose notation for binding a term of the programming language to a name, with some associated syntactic sugar, like the notation we see here for defining a function. That sugar could be expanded to yield this definition:Definition binopDenote : binop -> nat -> nat -> nat := fun (b : binop) =>

match b with

| Plus => plus

| Times => mult

end.

Definition binopDenote := fun b =>

match b with

| Plus => plus

| Times => mult

end.

*principal types*property, which gives us strong guarantees about how effective type inference will be. Unfortunately, Coq's type system is so expressive that any kind of "complete" type inference is impossible, and the task even seems to be hard in practice. Nonetheless, Coq includes some very helpful heuristics, many of them copying the workings of Haskell and ML type-checkers for programs that fall in simple fragments of Coq's language.*Calculus of Inductive Constructions*(CIC), which is an extension of the older*Calculus of Constructions*(CoC). CIC is quite a spartan foundation, which is helpful for proving metatheory but not so helpful for real development. Still, it is nice to know that it has been proved that CIC enjoys properties like*strong normalization*, meaning that every program (and, more importantly, every proof term) terminates; and*relative consistency*with systems like versions of Zermelo-Fraenkel set theory, which roughly means that you can believe that Coq proofs mean that the corresponding propositions are "really true," if you believe in set theory.*trees*of vernacular commands, thanks to various nested scoping constructs.)Fixpoint expDenote (e : exp) : nat :=

match e with

| Const n => n

| Binop b e1 e2 => (binopDenote b) (expDenote e1) (expDenote e2)

end.

We declare explicitly that this is a recursive definition, using the keyword Fixpoint. The rest should be old hat for functional programmers.
It is convenient to be able to test definitions before starting to prove things about them. We can verify that our semantics is sensible by evaluating some sample uses, using the command Eval. This command takes an argument expressing a
To return to our test evaluations, we run the Eval command using the simpl evaluation strategy, whose definition is best postponed until we have learned more about Coq's foundations, but which usually gets the job done.

*reduction strategy*, or an "order of evaluation." Unlike with ML, which hardcodes an*eager*reduction strategy, or Haskell, which hardcodes a*lazy*strategy, in Coq we are free to choose between these and many other orders of evaluation, because all Coq programs terminate. In fact, Coq silently checked termination of our Fixpoint definition above, using a simple heuristic based on monotonically decreasing size of arguments across recursive calls. Specifically, recursive calls must be made on arguments that were pulled out of the original recursive argument with match expressions. (In Chapter 7, we will see some ways of getting around this restriction, though simply removing the restriction would leave Coq useless as a theorem proving tool, for reasons we will start to learn about in the next chapter.)
= 28 : nat
Nothing too surprising goes on here, so we are ready to move on to the target language of our compiler.
We will compile our source programs onto a simple stack machine, whose syntax is:

## Target Language

Inductive instr : Set :=

| iConst : nat -> instr

| iBinop : binop -> instr.

Definition prog := list instr.

Definition stack := list nat.

An instruction either pushes a constant onto the stack or pops two arguments, applies a binary operator to them, and pushes the result onto the stack. A program is a list of instructions, and a stack is a list of natural numbers.
We can give instructions meanings as functions from stacks to optional stacks, where running an instruction results in None in case of a stack underflow and results in Some s' when the result of execution is the new stack s'. The infix operator :: is "list cons" from the Coq standard library.

Definition instrDenote (i : instr) (s : stack) : option stack :=

match i with

| iConst n => Some (n :: s)

| iBinop b =>

match s with

| arg1 :: arg2 :: s' => Some ((binopDenote b) arg1 arg2 :: s')

| _ => None

end

end.

With instrDenote defined, it is easy to define a function progDenote, which iterates application of instrDenote through a whole program.

Fixpoint progDenote (p : prog) (s : stack) : option stack :=

match p with

| nil => Some s

| i :: p' =>

match instrDenote i s with

| None => None

| Some s' => progDenote p' s'

end

end.

With the two programming languages defined, we can turn to the compiler definition.
Our compiler itself is now unsurprising. The list concatenation operator

## Translation

`++`comes from the Coq standard library.Fixpoint compile (e : exp) : prog :=

match e with

| Const n => iConst n :: nil

| Binop b e1 e2 => compile e2 ++ compile e1 ++ iBinop b :: nil

end.

Before we set about proving that this compiler is correct, we can try a few test runs, using our sample programs from earlier.

= iConst 7 :: iConst 2 :: iConst 2 :: iBinop Plus :: iBinop Times :: nil : prog
We can also run our compiled programs and check that they give the right results.

= Some (28 :: nil) : option stack
So far so good, but how can we be sure the compiler operates correctly for
We are ready to prove that our compiler is implemented correctly. We can use a new vernacular command Theorem to start a correctness proof, in terms of the semantics we defined earlier:

*all*input programs?## Translation Correctness

Though a pencil-and-paper proof might clock out at this point, writing "by a routine induction on e," it turns out not to make sense to attack this proof directly. We need to use the standard trick of

*strengthening the induction hypothesis*. We do that by proving an auxiliary lemma, using the command Lemma that is a synonym for Theorem, conventionally used for less important theorems that appear in the proofs of primary theorems.Abort.

Lemma compile_correct' : forall e p s,

progDenote (compile e ++ p) s = progDenote p (expDenote e :: s).

After the period in the Lemma command, we are in

1 subgoal

============================

forall (e : exp) (p : list instr) (s : stack),

progDenote (compile e ++ p) s = progDenote p (expDenote e :: s)

Coq seems to be restating the lemma for us. What we are seeing is a limited case of a more general protocol for describing where we are in a proof. We are told that we have a single subgoal. In general, during a proof, we can have many pending subgoals, each of which is a logical proposition to prove. Subgoals can be proved in any order, but it usually works best to prove them in the order that Coq chooses.
Next in the output, we see our single subgoal described in full detail. There is a double-dashed line, above which would be our free variables and hypotheses, if we had any. Below the line is the conclusion, which, in general, is to be proved from the hypotheses.
We manipulate the proof state by running commands called

*the interactive proof-editing mode*. We find ourselves staring at this ominous screen of text:1 subgoal

============================

forall (e : exp) (p : list instr) (s : stack),

progDenote (compile e ++ p) s = progDenote p (expDenote e :: s)

*tactics*. Let us start out by running one of the most important tactics:induction e.

We declare that this proof will proceed by induction on the structure of the expression e. This swaps out our initial subgoal for two new subgoals, one for each case of the inductive proof:

2 subgoals

n : nat

============================

forall (s : stack) (p : list instr),

progDenote (compile (Const n) ++ p) s =

progDenote p (expDenote (Const n) :: s)

subgoal 2 is

forall (s : stack) (p : list instr),

progDenote (compile (Binop b e1 e2) ++ p) s =

progDenote p (expDenote (Binop b e1 e2) :: s)

The first and current subgoal is displayed with the double-dashed line below free variables and hypotheses, while later subgoals are only summarized with their conclusions. We see an example of a free variable in the first subgoal; n is a free variable of type nat. The conclusion is the original theorem statement where e has been replaced by Const n. In a similar manner, the second case has e replaced by a generalized invocation of the Binop expression constructor. We can see that proving both cases corresponds to a standard proof by structural induction.
We begin the first case with another very common tactic.

2 subgoals

n : nat

============================

forall (s : stack) (p : list instr),

progDenote (compile (Const n) ++ p) s =

progDenote p (expDenote (Const n) :: s)

subgoal 2 is

forall (s : stack) (p : list instr),

progDenote (compile (Binop b e1 e2) ++ p) s =

progDenote p (expDenote (Binop b e1 e2) :: s)

intros.

The current subgoal changes to:

n : nat

s : stack

p : list instr

============================

progDenote (compile (Const n) ++ p) s =

progDenote p (expDenote (Const n) :: s)

We see that intros changes forall-bound variables at the beginning of a goal into free variables.
To progress further, we need to use the definitions of some of the functions appearing in the goal. The unfold tactic replaces an identifier with its definition.

n : nat

s : stack

p : list instr

============================

progDenote (compile (Const n) ++ p) s =

progDenote p (expDenote (Const n) :: s)

n : nat

s : stack

p : list instr

============================

progDenote ((iConst n :: nil) ++ p) s =

progDenote p (expDenote (Const n) :: s)

n : nat

s : stack

p : list instr

============================

progDenote ((iConst n :: nil) ++ p) s = progDenote p (n :: s)

n : nat

s : stack

p : list instr

============================

(fix progDenote (p0 : prog) (s0 : stack) {struct p0} :

option stack :=

match p0 with

| nil => Some s0

| i :: p' =>

match instrDenote i s0 with

| Some s' => progDenote p' s'

| None => None (A:=stack)

end

end) ((iConst n :: nil) ++ p) s =

progDenote p (n :: s)

simpl.

n : nat

s : stack

p : list instr

============================

(fix progDenote (p0 : prog) (s0 : stack) {struct p0} :

option stack :=

match p0 with

| nil => Some s0

| i :: p' =>

match instrDenote i s0 with

| Some s' => progDenote p' s'

| None => None (A:=stack)

end

end) p (n :: s) = progDenote p (n :: s)

n : nat

s : stack

p : list instr

============================

progDenote p (n :: s) = progDenote p (n :: s)

reflexivity.

On to the second inductive case:

b : binop

e1 : exp

IHe1 : forall (s : stack) (p : list instr),

progDenote (compile e1 ++ p) s = progDenote p (expDenote e1 :: s)

e2 : exp

IHe2 : forall (s : stack) (p : list instr),

progDenote (compile e2 ++ p) s = progDenote p (expDenote e2 :: s)

============================

forall (s : stack) (p : list instr),

progDenote (compile (Binop b e1 e2) ++ p) s =

progDenote p (expDenote (Binop b e1 e2) :: s)

We see our first example of hypotheses above the double-dashed line. They are the inductive hypotheses IHe1 and IHe2 corresponding to the subterms e1 and e2, respectively.
We start out the same way as before, introducing new free variables and unfolding and folding the appropriate definitions. The seemingly frivolous unfold/fold pairs are actually accomplishing useful work, because unfold will sometimes perform easy simplifications.

b : binop

e1 : exp

IHe1 : forall (s : stack) (p : list instr),

progDenote (compile e1 ++ p) s = progDenote p (expDenote e1 :: s)

e2 : exp

IHe2 : forall (s : stack) (p : list instr),

progDenote (compile e2 ++ p) s = progDenote p (expDenote e2 :: s)

============================

forall (s : stack) (p : list instr),

progDenote (compile (Binop b e1 e2) ++ p) s =

progDenote p (expDenote (Binop b e1 e2) :: s)

Now we arrive at a point where the tactics we have seen so far are insufficient. No further definition unfoldings get us anywhere, so we will need to try something different.

b : binop

e1 : exp

IHe1 : forall (s : stack) (p : list instr),

progDenote (compile e1 ++ p) s = progDenote p (expDenote e1 :: s)

e2 : exp

IHe2 : forall (s : stack) (p : list instr),

progDenote (compile e2 ++ p) s = progDenote p (expDenote e2 :: s)

s : stack

p : list instr

============================

progDenote ((compile e2 ++ compile e1 ++ iBinop b :: nil) ++ p) s =

progDenote p (binopDenote b (expDenote e1) (expDenote e2) :: s)

What we need is the associative law of list concatenation, which is available as a theorem app_assoc_reverse in the standard library. (Here and elsewhere, it is possible to tell the difference between inputs and outputs to Coq by periods at the ends of the inputs.)

b : binop

e1 : exp

IHe1 : forall (s : stack) (p : list instr),

progDenote (compile e1 ++ p) s = progDenote p (expDenote e1 :: s)

e2 : exp

IHe2 : forall (s : stack) (p : list instr),

progDenote (compile e2 ++ p) s = progDenote p (expDenote e2 :: s)

s : stack

p : list instr

============================

progDenote ((compile e2 ++ compile e1 ++ iBinop b :: nil) ++ p) s =

progDenote p (binopDenote b (expDenote e1) (expDenote e2) :: s)

Check app_assoc_reverse.

app_assoc_reverse

: forall (A : Type) (l m n : list A), (l ++ m) ++ n = l ++ m ++ n

SearchRewrite ((_ ++ _) ++ _).

app_assoc_reverse:

forall (A : Type) (l m n : list A), (l ++ m) ++ n = l ++ m ++ n

app_assoc: forall (A : Type) (l m n : list A), l ++ m ++ n = (l ++ m) ++ n

rewrite app_assoc_reverse.

changing the conclusion to:

progDenote (compile e2 ++ (compile e1 ++ iBinop b :: nil) ++ p) s =

progDenote p (binopDenote b (expDenote e1) (expDenote e2) :: s)

Now we can notice that the lefthand side of the equality matches the lefthand side of the second inductive hypothesis, so we can rewrite with that hypothesis, too.

progDenote (compile e2 ++ (compile e1 ++ iBinop b :: nil) ++ p) s =

progDenote p (binopDenote b (expDenote e1) (expDenote e2) :: s)

rewrite IHe2.

progDenote ((compile e1 ++ iBinop b :: nil) ++ p) (expDenote e2 :: s) =

progDenote p (binopDenote b (expDenote e1) (expDenote e2) :: s)

rewrite app_assoc_reverse.

rewrite IHe1.

progDenote ((iBinop b :: nil) ++ p) (expDenote e1 :: expDenote e2 :: s) =

progDenote p (binopDenote b (expDenote e1) (expDenote e2) :: s)

And the proof is completed, as indicated by the message:
And there lies our first proof. Already, even for simple theorems like this, the final proof script is unstructured and not very enlightening to readers. If we extend this approach to more serious theorems, we arrive at the unreadable proof scripts that are the favorite complaints of opponents of tactic-based proving. Fortunately, Coq has rich support for scripted automation, and we can take advantage of such a scripted tactic (defined elsewhere) to make short work of this lemma. We abort the old proof attempt and start again.

Proof completed.

Abort.

Lemma compile_correct' : forall e s p, progDenote (compile e ++ p) s =

progDenote p (expDenote e :: s).

induction e; crush.

Qed.

We need only to state the basic inductive proof scheme and call a tactic that automates the tedious reasoning in between. In contrast to the period tactic terminator from our last proof, the semicolon tactic separator supports structured, compositional proofs. The tactic t1; t2 has the effect of running t1 and then running t2 on each remaining subgoal. The semicolon is one of the most fundamental building blocks of effective proof automation. The period terminator is very useful for exploratory proving, where you need to see intermediate proof states, but final proofs of any serious complexity should have just one period, terminating a single compound tactic that probably uses semicolons.
The crush tactic comes from the library associated with this book and is not part of the Coq standard library. The book's library contains a number of other tactics that are especially helpful in highly automated proofs.
The Qed command checks that the proof is finished and, if so, saves it. The tactic commands we have written above are an example of a
The proof of our main theorem is now easy. We prove it with four period-terminated tactics, though separating them with semicolons would work as well; the version here is easier to step through.

*proof script*, or a series of Ltac programs; while Qed uses the result of the script to generate a*proof term*, a well-typed term of Gallina. To believe that a theorem is true, we only need to trust that the (relatively simple) checker for proof terms is correct; the use of proof scripts is immaterial. Part I of this book will introduce the principles behind encoding all proofs as terms of Gallina.e : exp

============================

progDenote (compile e) nil = Some (expDenote e :: nil)

Check app_nil_end.

This time, we explicitly specify the value of the variable l from the theorem statement, since multiple expressions of list type appear in the conclusion. The rewrite tactic might choose the wrong place to rewrite if we did not specify which we want.

e : exp

============================

progDenote (compile e ++ nil) nil = Some (expDenote e :: nil)

Now we can apply the lemma.

e : exp

============================

progDenote (compile e ++ nil) nil = Some (expDenote e :: nil)

e : exp

============================

progDenote nil (expDenote e :: nil) = Some (expDenote e :: nil)

reflexivity.

Qed.

This proof can be shortened and automated, but we leave that task as an exercise for the reader.
In this section, we will build on the initial example by adding additional expression forms that depend on static typing of terms for safety.
We define a trivial language of types to classify our expressions:

# Typed Expressions

## Source Language

Like most programming languages, Coq uses case-sensitive variable names, so that our user-defined type type is distinct from the Type keyword that we have already seen appear in the statement of a polymorphic theorem (and that we will meet in more detail later), and our constructor names Nat and Bool are distinct from the types nat and bool in the standard library.
Now we define an expanded set of binary operators.

Inductive tbinop : type -> type -> type -> Set :=

| TPlus : tbinop Nat Nat Nat

| TTimes : tbinop Nat Nat Nat

| TEq : forall t, tbinop t t Bool

| TLt : tbinop Nat Nat Bool.

The definition of tbinop is different from binop in an important way. Where we declared that binop has type Set, here we declare that tbinop has type type -> type -> type -> Set. We define tbinop as an
The intuitive explanation of tbinop is that a tbinop t1 t2 t is a binary operator whose operands should have types t1 and t2, and whose result has type t. For instance, constructor TLt (for less-than comparison of numbers) is assigned type tbinop Nat Nat Bool, meaning the operator's arguments are naturals and its result is Boolean. The type of TEq introduces a small bit of additional complication via polymorphism: we want to allow equality comparison of any two values of any type, as long as they have the
ML and Haskell have indexed algebraic datatypes. For instance, their list types are indexed by the type of data that the list carries. However, compared to Coq, ML and Haskell 98 place two important restrictions on datatype definitions.
First, the indices of the range of each data constructor must be type variables bound at the top level of the datatype definition. There is no way to do what we did here, where we, for instance, say that TPlus is a constructor building a tbinop whose indices are all fixed at Nat.
The second restriction is not lifted by GADTs. In ML and Haskell, indices of types must be types and may not be
We can define a similar type family for typed expressions, where a term of type texp t can be assigned object language type t. (It is conventional in the world of interactive theorem proving to call the language of the proof assistant the

*indexed type family*. Indexed inductive types are at the heart of Coq's expressive power; almost everything else of interest is defined in terms of them.*same*type.*Generalized algebraic datatypes*(GADTs) are a popular feature in GHC Haskell, OCaml 4, and other languages that removes this first restriction.*expressions*. In Coq, types may be indexed by arbitrary Gallina terms. Type indices can live in the same universe as programs, and we can compute with them just like regular programs. Haskell supports a hobbled form of computation in type indices based on multi-parameter type classes, and recent extensions like type functions bring Haskell programming even closer to "real" functional programming with types, but, without dependent typing, there must always be a gap between how one programs with types and how one programs normally.*meta language*and a language being formalized the*object language*.)Inductive texp : type -> Set :=

| TNConst : nat -> texp Nat

| TBConst : bool -> texp Bool

| TBinop : forall t1 t2 t, tbinop t1 t2 t -> texp t1 -> texp t2 -> texp t.

Thanks to our use of dependent types, every well-typed texp represents a well-typed source expression, by construction. This turns out to be very convenient for many things we might want to do with expressions. For instance, it is easy to adapt our interpreter approach to defining semantics. We start by defining a function mapping the types of our object language into Coq types:

It can take a few moments to come to terms with the fact that Set, the type of types of programs, is itself a first-class type, and that we can write functions that return Sets. Past that wrinkle, the definition of typeDenote is trivial, relying on the nat and bool types from the Coq standard library. We can interpret binary operators by relying on standard-library equality test functions eqb and beq_nat for Booleans and naturals, respectively, along with a less-than test leb:

Definition tbinopDenote arg1 arg2 res (b : tbinop arg1 arg2 res)

: typeDenote arg1 -> typeDenote arg2 -> typeDenote res :=

match b with

| TPlus => plus

| TTimes => mult

| TEq Nat => beq_nat

| TEq Bool => eqb

| TLt => leb

end.

This function has just a few differences from the denotation functions we saw earlier. First, tbinop is an indexed type, so its indices become additional arguments to tbinopDenote. Second, we need to perform a genuine
The same tricks suffice to define an expression denotation function in an unsurprising way. Note that the type arguments to the TBinop constructor must be included explicitly in pattern-matching, but here we write underscores because we do not need to refer to those arguments directly.

*dependent pattern match*, where the necessary*type*of each case body depends on the*value*that has been matched. At this early stage, we will not go into detail on the many subtle aspects of Gallina that support dependent pattern-matching, but the subject is central to Part II of the book.Fixpoint texpDenote t (e : texp t) : typeDenote t :=

match e with

| TNConst n => n

| TBConst b => b

| TBinop _ _ _ b e1 e2 => (tbinopDenote b) (texpDenote e1) (texpDenote e2)

end.

We can evaluate a few example programs to convince ourselves that this semantics is correct.

= true : typeDenote Bool
Now we are ready to define a suitable stack machine target for compilation.
In the example of the untyped language, stack machine programs could encounter stack underflows and "get stuck." This was unfortunate, since we had to deal with this complication even though we proved that our compiler never produced underflowing programs. We could have used dependent types to force all stack machine programs to be underflow-free.
For our new languages, besides underflow, we also have the problem of stack slots with naturals instead of bools or vice versa. This time, we will use indexed typed families to avoid the need to reason about potential failures.
We start by defining stack types, which classify sets of possible stacks.

## Target Language

Any stack classified by a tstack must have exactly as many elements, and each stack element must have the type found in the same position of the stack type.
We can define instructions in terms of stack types, where every instruction's type tells us what initial stack type it expects and what final stack type it will produce.

Inductive tinstr : tstack -> tstack -> Set :=

| TiNConst : forall s, nat -> tinstr s (Nat :: s)

| TiBConst : forall s, bool -> tinstr s (Bool :: s)

| TiBinop : forall arg1 arg2 res s,

tbinop arg1 arg2 res

-> tinstr (arg1 :: arg2 :: s) (res :: s).

Stack machine programs must be a similar inductive family, since, if we again used the list type family, we would not be able to guarantee that intermediate stack types match within a program.

Inductive tprog : tstack -> tstack -> Set :=

| TNil : forall s, tprog s s

| TCons : forall s1 s2 s3,

tinstr s1 s2

-> tprog s2 s3

-> tprog s1 s3.

Now, to define the semantics of our new target language, we need a representation for stacks at runtime. We will again take advantage of type information to define types of value stacks that, by construction, contain the right number and types of elements.

Fixpoint vstack (ts : tstack) : Set :=

match ts with

| nil => unit

| t :: ts' => typeDenote t * vstack ts'

end%type.

This is another Set-valued function. This time it is recursive, which is perfectly valid, since Set is not treated specially in determining which functions may be written. We say that the value stack of an empty stack type is any value of type unit, which has just a single value, tt. A nonempty stack type leads to a value stack that is a pair, whose first element has the proper type and whose second element follows the representation for the remainder of the stack type. We write %
This idea of programming with types can take a while to internalize, but it enables a very simple definition of instruction denotation. Our definition is like what you might expect from a Lisp-like version of ML that ignored type information. Nonetheless, the fact that tinstrDenote passes the type-checker guarantees that our stack machine programs can never go wrong. We use a special form of let to destructure a multi-level tuple.

`type`as an instruction to Coq's extensible parser. In particular, this directive applies to the whole match expression, which we ask to be parsed as though it were a type, so that the operator * is interpreted as Cartesian product instead of, say, multiplication. (Note that this use of`type`has no connection to the inductive type type that we have defined.)Definition tinstrDenote ts ts' (i : tinstr ts ts') : vstack ts -> vstack ts' :=

match i with

| TiNConst _ n => fun s => (n, s)

| TiBConst _ b => fun s => (b, s)

| TiBinop _ _ _ _ b => fun s =>

let '(arg1, (arg2, s')) := s in

((tbinopDenote b) arg1 arg2, s')

end.

Why do we choose to use an anonymous function to bind the initial stack in every case of the match? Consider this well-intentioned but invalid alternative version:

Definition tinstrDenote ts ts' (i : tinstr ts ts') (s : vstack ts) : vstack ts' :=

match i with

| TiNConst _ n => (n, s)

| TiBConst _ b => (b, s)

| TiBinop _ _ _ _ b =>

let '(arg1, (arg2, s')) := s in

((tbinopDenote b) arg1 arg2, s')

end.
The Coq type checker complains that:
This and other mysteries of Coq dependent typing we postpone until Part II of the book. The upshot of our later discussion is that it is often useful to push inside of match branches those function parameters whose types depend on the type of the value being matched. Our later, more complete treatment of Gallina's typing rules will explain why this helps.
We finish the semantics with a straightforward definition of program denotation.

Definition tinstrDenote ts ts' (i : tinstr ts ts') (s : vstack ts) : vstack ts' :=

match i with

| TiNConst _ n => (n, s)

| TiBConst _ b => (b, s)

| TiBinop _ _ _ _ b =>

let '(arg1, (arg2, s')) := s in

((tbinopDenote b) arg1 arg2, s')

end.

The term "(n, s)" has type "(nat * vstack ts)%type" while it is expected to have type "vstack ?119".

Fixpoint tprogDenote ts ts' (p : tprog ts ts') : vstack ts -> vstack ts' :=

match p with

| TNil _ => fun s => s

| TCons _ _ _ i p' => fun s => tprogDenote p' (tinstrDenote i s)

end.

The same argument-postponing trick is crucial for this definition.
To define our compilation, it is useful to have an auxiliary function for concatenating two stack machine programs.

## Translation

Fixpoint tconcat ts ts' ts'' (p : tprog ts ts') : tprog ts' ts'' -> tprog ts ts'' :=

match p with

| TNil _ => fun p' => p'

| TCons _ _ _ i p1 => fun p' => TCons i (tconcat p1 p')

end.

With that function in place, the compilation is defined very similarly to how it was before, modulo the use of dependent typing.

Fixpoint tcompile t (e : texp t) (ts : tstack) : tprog ts (t :: ts) :=

match e with

| TNConst n => TCons (TiNConst _ n) (TNil _)

| TBConst b => TCons (TiBConst _ b) (TNil _)

| TBinop _ _ _ b e1 e2 => tconcat (tcompile e2 _)

(tconcat (tcompile e1 _) (TCons (TiBinop _ b) (TNil _)))

end.

One interesting feature of the definition is the underscores appearing to the right of => arrows. Haskell and ML programmers are quite familiar with compilers that infer type parameters to polymorphic values. In Coq, it is possible to go even further and ask the system to infer arbitrary terms, by writing underscores in place of specific values. You may have noticed that we have been calling functions without specifying all of their arguments. For instance, the recursive calls here to tcompile omit the t argument. Coq's
The underscores here are being filled in with stack types. That is, the Coq type inferencer is, in a sense, inferring something about the flow of control in the translated programs. We can take a look at exactly which values are filled in:

*implicit argument*mechanism automatically inserts underscores for arguments that it will probably be able to infer. Inference of such values is far from complete, though; generally, it only works in cases similar to those encountered with polymorphic type instantiation in Haskell and ML.tcompile =

fix tcompile (t : type) (e : texp t) (ts : tstack) {struct e} :

tprog ts (t :: ts) :=

match e in (texp t0) return (tprog ts (t0 :: ts)) with

| TNConst n => TCons (TiNConst ts n) (TNil (Nat :: ts))

| TBConst b => TCons (TiBConst ts b) (TNil (Bool :: ts))

| TBinop arg1 arg2 res b e1 e2 =>

tconcat (tcompile arg2 e2 ts)

(tconcat (tcompile arg1 e1 (arg2 :: ts))

(TCons (TiBinop ts b) (TNil (res :: ts))))

end

: forall t : type, texp t -> forall ts : tstack, tprog ts (t :: ts)

Eval simpl in tprogDenote (tcompile (TBinop TTimes (TBinop TPlus (TNConst 2)

(TNConst 2)) (TNConst 7)) nil) tt.

Eval simpl in tprogDenote (tcompile (TBinop (TEq Nat) (TBinop TPlus (TNConst 2)

(TNConst 2)) (TNConst 7)) nil) tt.

Eval simpl in tprogDenote (tcompile (TBinop TLt (TBinop TPlus (TNConst 2) (TNConst 2))

(TNConst 7)) nil) tt.

= (true, tt) : vstack (Bool :: nil)
The compiler seems to be working, so let us turn to proving that it
We can state a correctness theorem similar to the last one.

*always*works.## Translation Correctness

Theorem tcompile_correct : forall t (e : texp t),

tprogDenote (tcompile e nil) tt = (texpDenote e, tt).

Again, we need to strengthen the theorem statement so that the induction will go through. This time, to provide an excuse to demonstrate different tactics, I will develop an alternative approach to this kind of proof, stating the key lemma as:

Lemma tcompile_correct' : forall t (e : texp t) ts (s : vstack ts),

tprogDenote (tcompile e ts) s = (texpDenote e, s).

While lemma compile_correct' quantified over a program that is the "continuation" for the expression we are considering, here we avoid drawing in any extra syntactic elements. In addition to the source expression and its type, we also quantify over an initial stack type and a stack compatible with it. Running the compilation of the program starting from that stack, we should arrive at a stack that differs only in having the program's denotation pushed onto it.
Let us try to prove this theorem in the same way that we settled on in the last section.

induction e; crush.

We are left with this unproved conclusion:

tprogDenote

(tconcat (tcompile e2 ts)

(tconcat (tcompile e1 (arg2 :: ts))

(TCons (TiBinop ts t) (TNil (res :: ts))))) s =

(tbinopDenote t (texpDenote e1) (texpDenote e2), s)

We need an analogue to the app_assoc_reverse theorem that we used to rewrite the goal in the last section. We can abort this proof and prove such a lemma about tconcat.

tprogDenote

(tconcat (tcompile e2 ts)

(tconcat (tcompile e1 (arg2 :: ts))

(TCons (TiBinop ts t) (TNil (res :: ts))))) s =

(tbinopDenote t (texpDenote e1) (texpDenote e2), s)

Abort.

Lemma tconcat_correct : forall ts ts' ts'' (p : tprog ts ts') (p' : tprog ts' ts'')

(s : vstack ts),

tprogDenote (tconcat p p') s

= tprogDenote p' (tprogDenote p s).

induction p; crush.

Qed.

This one goes through completely automatically.
Some code behind the scenes registers app_assoc_reverse for use by crush. We must register tconcat_correct similarly to get the same effect:

Here we meet the pervasive concept of a
Now we are ready to return to tcompile_correct', proving it automatically this time.

*hint*. Many proofs can be found through exhaustive enumerations of combinations of possible proof steps; hints provide the set of steps to consider. The tactic crush is applying such brute force search for us silently, and it will consider more possibilities as we add more hints. This particular hint asks that the lemma be used for left-to-right rewriting.Lemma tcompile_correct' : forall t (e : texp t) ts (s : vstack ts),

tprogDenote (tcompile e ts) s = (texpDenote e, s).

induction e; crush.

Qed.

We can register this main lemma as another hint, allowing us to prove the final theorem trivially.

Hint Rewrite tcompile_correct'.

Theorem tcompile_correct : forall t (e : texp t),

tprogDenote (tcompile e nil) tt = (texpDenote e, tt).

crush.

Qed.

It is probably worth emphasizing that we are doing more than building mathematical models. Our compilers are functional programs that can be executed efficiently. One strategy for doing so is based on
To set up the feature properly in recent versions of Coq, we must run the command Require Extraction.. However, this book HTML is still built with a patched old version of Coq that neither requires nor allows that command, so it is commented out in this rendering!
Now we run a command to output the OCaml version of tcompile:

*program extraction*, which generates OCaml code from Coq developments.let rec tcompile t e ts = match e with | TNConst n -> TCons (ts, (Cons (Nat, ts)), (Cons (Nat, ts)), (TiNConst (ts, n)), (TNil (Cons (Nat, ts)))) | TBConst b -> TCons (ts, (Cons (Bool, ts)), (Cons (Bool, ts)), (TiBConst (ts, b)), (TNil (Cons (Bool, ts)))) | TBinop (t1, t2, t0, b, e1, e2) -> tconcat ts (Cons (t2, ts)) (Cons (t0, ts)) (tcompile t2 e2 ts) (tconcat (Cons (t2, ts)) (Cons (t1, (Cons (t2, ts)))) (Cons (t0, ts)) (tcompile t1 e1 (Cons (t2, ts))) (TCons ((Cons (t1, (Cons (t2, ts)))), (Cons (t0, ts)), (Cons (t0, ts)), (TiBinop (t1, t2, t0, ts, b)), (TNil (Cons (t0, ts))))))