Lesson 1. Lisp
ACL2 uses a subset of the Lisp programming language. Lisp syntax is one of the simplest ones of any programming language. However, it is different from most other languages, so let's take a moment to get acquainted with it.
First of all, every operation in Lisp is a function. Even very basic mathematical operations, such as addition. Secondly, functions are called in a different way than they are in mathematics or in most other languages. While in most languages, you might write
f(x, y), in Lisp, you write
(f x y).
The addition function is called
+. Try adding two numbers now:
(+ 1 2)
Tip: You can click on any code you see in this tutorial to insert it at the prompt.
'Lisp' is short for 'list processing'. Lists, specifically linked lists, are a fundamental part of how Lisp represents and manipulates data. The function used to create a list is called, appropriately,
list. Try creating a list:
(list 8 6 7 5 3 0 9)
You can use the single quote mark as a type of shorthand for creating lists. Unlike with
(list ...), the single quote marker also "quotes" the items inside of it. While
(list 1 2 (+ 1 2)) would be the same as
(list 1 2 3),
'(1 2 (+ 1 2)) is the same as
(list 1 2 (list '+ 1 2)).
The single quoted + sign,
'+ is called a "symbol". You can use the single quote to create symbols out of sequences of characters, such as
append concatenates two (or more) lists together. Try:
(append '(1 2 3) '(4 5 6))
There are two more basic types of values in ACL2 that are important: strings and booleans. Strings are double quoted,
"like this". The two boolean values are
t (for true) and
nil (for false). Actually, any value (except
nil) is considered to be true for boolean tests. Use
t if no other value makes more sense.
The primary use for boolean functions and values is to branch using the
(if ...) function.
(if test if-true if-false)
Try it now with one of the simple boolean values:
(if t "True" "False")
(if ...) doesn't do much good here; you already know that t is true. You'll almost always call (if ...) with a function call for the second parameter. Here are some functions that return boolean values:
(< a b) (> a b) (<= a b) (>= a b) (= a b) (/= a b)
These are the six equality and inequality tests. They should be familiar to you. The final one is 'not equal'; the slash is meant to signify the crossed out equal sign of mathematics.
(integerp x) (rationalp x) (acl2-numberp x) (complex-rationalp x) (natp x)
These functions 'recognize' some of the different types of numbers available in ACL2 (that is, they return
t when their argument is of the requested type;
(integerp x) returns
x is an integer). The terminal '
p' is a common idiom from Lisp and means "predicate". You can imagine it as a sort of question mark;
(natp i) means "Is
i an natural number?".
(if (= (+ 1 3) (+ 5 2 -3)) "Equal" "Not equal")
(endp xs) (listp xs) (true-listp xs) (equal xs ys)
These functions relate to lists.
(endp xs) checks to see if
xs is an empty list (if we are "at the end" of the list, a phrasing that makes sense if you think about these functions as they are used recursively).
(listp xs) is a recognizer for lists.
(true-listp xs) is a stronger recognizer for lists that checks to see if the marker used for the empty list is
nil, as it is in the system-created lists. Most ACL2 functions are intended to work with "true" lists, like the ones you can construct with
(equal ...) tests the equality of lists (or more simple elements).
(= ...) is intended for numbers.
As a side note, I often use
zs, etc), pronounced like English plurals ("exes", "whys", "zees"), for lists and
y, etc. for numbers or simple values. This is just a convention, not a part of Lisp.
This time, try:
(true-listp '(a b c)) to verify what I asserted earlier.
By now, if you're an experienced programmer, you're probably expecting a way to assign variables. However, one of the important parts of how ACL2 differs from regular Common Lisp is that it does not allow variables to be modified in place. In essence, it doesn't allow variables at all; only constants and aliases.
Instead, to produce meaningful or complex programs, you'll need to modify and return variables by creating new ones. This may seem unusual and may take some time to get accustomed to if you've never used an applicative programming language, but once you get the hang of it, it's pretty easy.
Lets start with aliases. They are a good way to "save" the results of a complex computation and use it more than once, so you don't have to redo expensive operations. Aliasing is done with the
(let ((alias1 value1) (alias2 value2) ...) body)
where the aliases are symbols, just like before (but without the ') and the values are either literal values, or, more often, function calls.
(let ((xs (append '(1 2 3) '(4 5 6)))) (and (listp xs) (true-listp xs)))
In the previous example, I snuck in an extra simple operator:
(and ...). It does what you'd expect from boolean algebra, and you can also use
(implies p q), etc.
There's one final important built-in function that I'd like to introduce. To compute the length of a list, use (len xs):
(len '(1 2 3 4)).
Lesson 2. Functions
Now that you've got a basic understanding of some of the built-in functions of lisp, let's move on to defining new ones. The function you use to define new functions is
(defun name (param1 param2 ...) body)
Try adding this function that squares numbers:
(defun square (x) (* x x)).
An important thing happened here: in addition to just adding the new function, ACL2 did something interesting: it proved that no matter what input you give to your new function, it will, eventually, complete. It won't loop or call itself forever. Now, that's not too surprising, given how simple
(square ...) is. But it can be quite a task for complex functions.
Try out your new function now by squaring some of the types of numbers that ACL2 supports.
Next, we're going to enter a recursive function;
factorial. The factorial of a natural number is the product of the number and all the natural numbers below it. In other words,
(factorial n) =
(* n (factorial (- n 1))). As a special case (called the "base case"),
(factorial 0) = 1. A naive (but wrong) approach might be this:
(defun factorial-wrong (n)
(if (= n 0)
(* n (factorial-wrong (- n 1)))))
You can try adding this to ACL2, but it won't work. To see what's wrong, imagine calling factorial on the (perfectly valid) ACL2 number
(* -1 (factorial -2))
(* -1 (* -2 (factorial -3)))
Uh oh. You can clearly see that this will never terminate. ACL2 functions are 'total', meaning that they must be able to accept any object of any type and return something in a finite amount of time, even if it's not necessarily a useful response. Keep this in mind as you define ACL2 functions.
When defining functions like
factorial that recurse "towards" 0 and where you only care about natural numbers, use the function
zp (the "zero predicate").
(zp n) is
t when n is zero. But it's also
t if n is not a natural number. So it returns the "base case" if n is something weird, like a list or a complex number. Try this definition of
(defun factorial (n)
(if (zp n)
(* n (factorial (- n 1)))))
You'll notice that
(factorial (list 1 2 3)) returns
1, an inapplicable answer. This is a little messy, but fine. ACL2 is type-free, so it has to give an answer for any arguments. One approach (not covered here) to making this easier to use is to add
:guards to functions and turn on guard checking to ensure that users don't execute your functions on irrelevant values. (The prover, on the other hand, ignores guards, so it's best to do the same for now).
Now let's try defining a function on lists;
rev, which reverses the list you give it. The base case for
rev is the empty list, the reverse of which is just the empty list. For the general case, the reversed list is just the reversed "rest" of the list with the "first" element at the end, like so:
(defun rev (xs)
(if (endp xs)
(append (rev (rest xs))
(list (first xs)))))
Lesson 3. Theorems
Of course, proving that functions terminate is only a small part of proving that they work. ACL2 also lets you prove arbitrary theorems about functions. We will start out using the
(thm ...) function to do this. Try the following pretty obvious theorem:
(thm (= (+ a b) (+ b a)))
The proof for that theorem isn't very interesting. ACL2 just applies the built-in knowledge it has of linear arithmetic. How about a theorem about our previously-defined factorial function:
(thm (> (factorial n) 0))
Again, a relatively simple proof. For this one, ACL2 uses the fact that when it admitted
factorial, it determined that the result was always a positive integer and stored that as a as a special kind of rule known as a :type-prescription rule. (ACL2 supports numerous kinds of rules, but we need not go into that
Let's prove that the built in
append function from earlier is associative; that is,
(append (append xs ys) zs) equals
(append xs (append ys zs)).
(thm (equal (append (append xs ys) zs)
(append xs (append ys zs))))
This is a long, (but interesting!) proof. If you're interested in the details, there's a good, relatively non-technical discussion of this proof by the authors of ACL2 here.
For theorems that ACL2 can't prove on its own, you'll often have to provide lemmas; theorems that are added to the ACL2 logical world and can then be used in proving future theorems. To add a theorem to the logical world, use
(defthm ...) and give it a name.
(equal (append (append xs ys) zs)
(append xs (append ys zs))))
Theorems added using this method must be written with care; the prover blindly
replaces the left side with the right side whenever it finds something that
looks like the left side and can prove all of the
implies hypotheses. If we
admitted a different version of append-associative that converted
(append ys zs)) to
(append (append xs ys)), the theorem prover would loop
forever, applying these two rules repeatedly.
A final easy theorem before we move on to more difficult theorems is that reversing a list twice yields the original list.
The proof of this one is also interesting. In proving rev-rev, the prover identifies the need for a simpler lemma, namely, that
(rev (append xs (list x))) equals
(cons x (rev xs)), and proves it using a second induction.
(implies (true-listp xs)
(equal (rev (rev xs)) xs)))
This tutorial is a work in progress
For a more in-depth look at ACL2, see this page with some tutorials curated by the developers of ACL2. You can also try Proof Pad, an ACL2 IDE geared towards beginners.
Feel free to email any comments you have to me at firstname.lastname@example.org, and come back for more later.