Overview

Matching (of all kinds) is used for

The examples below are based on the pattern matcher defined in match.lisp, which can be loaded in the CS325 package with

(ql:quickload :exmatch)

A pattern matcher takes a pattern and an object that is not a pattern. A pattern can be

Note the recursive nature of this definition. Here are some patterns:

(like mary jon)
(like ?x ?y)
(?fn ?arg1 ?arg2)
(?fn (null ?x))

Here's what matches what and why:

PatternInputMatches?
mary mary Yes, they're equal
(like mary jon) (like mary jon) Yes, they're equal
(like mary jon) (like jon mary) No, they're not equal
(like ?x ?y) (like jon mary) Yes, and ?x is jon and ?y is mary
(like ?x ?x) (like jon mary) No, ?x can't be jon and mary at the same time
(like ?x ?x) (like jon jon) Yes, ?x is jon
(like ?x ?y) (like jon jon) Yes, ?x and ?y are both jon

Basic Pattern Match Rules

The basic rule for pattern matching is simple. Given a pattern P and an S-expression S, P matches S if

A variable P can be "bound" to S if

The anonymous variable ? is treated specially. It matches anything but is never bound.

The matcher returns a list of binding lists. NIL means there are no binding lists, i.e., the match failed

Binding Lists

A binding list is simply a list of the variables in a pattern, paired with the items those variables matched in the input S-expression. For example, the binding list

((?x . jon) (?y . mary))

says that the variable ?x is bound to jon and the variable ?y is bound to mary.

Why does the pattern matcher return a list of binding lists? For two reasons:

The "success but no bindings" problem: Consider matching (likes mary jon)with (likes mary jon). This clearly matches but equally clearly generates no bindings. If our matcher returned just a binding list, it would return NIL in this case which looks like the match failed.

The multiple bindings problem: Multiple binding lists arise as soon as we add more powerful forms to patterns. For example, the pattern variable ?* inside a list can match zero or more elements. Here are some examples:

PatternInputBindings
(like ?* ?x) (like mary jon) ?x is bound to jon
(like ?x ?*) (like mary jon) ?x is bound to mary
(like ?* ?x ?*) (like mary jon) ?x is bound to mary OR
?x is bound to jon

The last case is the important one. There are two equally valid bindings, depending on how many elements ?* skips.

Other approaches

Many authors treat the "success but no bindings" case specially and return T. While intuitive, this means that every function that calls the pattern matcher, including the internal recursive calls of the matcher itself, have to check for three possible values: NIL, T, or a list. This leads to code cluttered with conditionals, and doesn't handle multiple biniding lists.

Other authors, including Graham in Chapter 15, return multiple values: the binding list and a flag indicating whether the match succeeded or failed. Again, you lose the simple recursive calling pattern and you still don't handle multiple binding lists.

Using multiple binding lists from the start, while less intuitive at first glance, leads to simpler but more powerful code with a clean single return value:

Matching returns a list of all possible binding lists.

If the list is NIL, there were no possible binding lists and the match must have failed.

If the list is (NIL), that's the list of one binding list which happens to be the empty binding list.

There are no special cases with this approach. All code that calls the matcher can simply iterate through the list returned (which will usually have 0 or 1 lists in it) to process each binding list. No special checks.