WHEN and UNLESS

As you’ve already seen, the most basic form of conditional execution—if x, do y; otherwise do z--is provided by the **IF** special operator, which has this basic form:

  1. (if condition then-form [else-form])

The condition is evaluated and, if its value is non-**NIL**, the then-form is evaluated and the resulting value returned. Otherwise, the else-form, if any, is evaluated and its value returned. If condition is **NIL** and there’s no else-form, then the **IF** returns **NIL**.

  1. (if (> 2 3) "Yup" "Nope") ==> "Nope"
  2. (if (> 2 3) "Yup") ==> NIL
  3. (if (> 3 2) "Yup" "Nope") ==> "Yup"

However, **IF** isn’t actually such a great syntactic construct because the then-form and else-form are each restricted to being a single Lisp form. This means if you want to perform a sequence of actions in either clause, you need to wrap them in some other syntax. For instance, suppose in the middle of a spam-filtering program you wanted to both file a message as spam and update the spam database when a message is spam. You can’t write this:

  1. (if (spam-p current-message)
  2. (file-in-spam-folder current-message)
  3. (update-spam-database current-message))

because the call to update-spam-database will be treated as the else clause, not as part of the then clause. Another special operator, **PROGN**, executes any number of forms in order and returns the value of the last form. So you could get the desired behavior by writing the following:

  1. (if (spam-p current-message)
  2. (progn
  3. (file-in-spam-folder current-message)
  4. (update-spam-database current-message)))

That’s not too horrible. But given the number of times you’ll likely have to use this idiom, it’s not hard to imagine that you’d get tired of it after a while. “Why,” you might ask yourself, “doesn’t Lisp provide a way to say what I really want, namely, ‘When x is true, do this, that, and the other thing’?” In other words, after a while you’d notice the pattern of an **IF** plus a **PROGN** and wish for a way to abstract away the details rather than writing them out every time.

This is exactly what macros provide. In this case, Common Lisp comes with a standard macro, **WHEN**, which lets you write this:

  1. (when (spam-p current-message)
  2. (file-in-spam-folder current-message)
  3. (update-spam-database current-message))

But if it wasn’t built into the standard library, you could define **WHEN** yourself with a macro such as this, using the backquote notation I discussed in Chapter 3:3

  1. (defmacro when (condition &rest body)
  2. `(if ,condition (progn ,@body)))

A counterpart to the **WHEN** macro is **UNLESS**, which reverses the condition, evaluating its body forms only if the condition is false. In other words:

  1. (defmacro unless (condition &rest body)
  2. `(if (not ,condition) (progn ,@body)))

Admittedly, these are pretty trivial macros. There’s no deep black magic here; they just abstract away a few language-level bookkeeping details, allowing you to express your true intent a bit more clearly. But their very triviality makes an important point: because the macro system is built right into the language, you can write trivial macros like **WHEN** and **UNLESS** that give you small but real gains in clarity that are then multiplied by the thousands of times you use them. In Chapters 24, 26, and 31 you’ll see how macros can also be used on a larger scale, creating whole domain-specific embedded languages. But first let’s finish our discussion of the standard control-construct macros.