Center for Analysis and Design of Intelligent Agents

• Lisp Tutorial
• LispBox - easy one-install Lisp implementations
• More material for learning Lisp:
  • Lisp Primer - A tutorial
  • Practical Common Lisp - A freely available book on Lisp
• Emacs reference card (PDF)

Work through the following exercises. Refer to the above material for more information.

1. Emacs and REPL:
   Install LispBox on your computer and start it up. The lower window is the Lisp REPL (read-eval-print loop) where you can enter Lisp expressions and have them evaluated.
2. Hello World:
   Type an expression prints “Hello World!” on the screen.
   

   ;; A typical print expression
   (print "Here is some text")

3. Lisp basics:
   Go through the sections Evaluating simple expressions, Evaluating Lists as Functions and Control Structures and Variables in this tutorial. Some expressions will generate an error, in that case the top window will show a message and a list of options. The safe option is always [ABORT REQUEST].
4. Defining functions:
   Go through the section Writing Functions in the tutorial. You can skip typing the examples in boxes 3, 5, 6, 7, 8 and 9 - but read the examples and try to understand them. Write a function that asks the user for their name and prints “Hello, <name>!” on the screen.
   

   ;; An example of getting input from a user and printing it
   (defun repeat-what-you-say ()
     (let ((what-you-said))
       (print "Please say something and type enter:")
       (setf what-you-said (read-line t))
       (print (concatenate 'string "You said: " what-you-said))))

   Note that in the REPL, you will see the printed output as well as the return value of the function. The return value is (as you should know by now) the result of the last expression of the function body. Since the PRINT function returns its argument, the function above also returns it, which is why it is printed twice in the REPL.

5. Lists as data:
   So far we've only seen lists used to call functions. However they can also be used to store data. Go through the section Lists and Symbols as Data in the tutorial. Feel free to skip the exercises that you feel you understand well, but make sure you understand how quoting (e.g. '(1 2 3)) works.
   The tutorial does not talk about keyword lists, which we will use. Keyword lists are created with the following syntax:
   

   '(:keyword "value" :numberfield 123)

   You can access the fields of a keyword list with the GETF function:
   

   CL-USER> (getf '(:a 1 :b 2 :c 3) :b)
   2

   You can read more about keyword lists in chapter 2 of Practical Common Lisp. For more information about quoting, see this page of the Lisp Primer, and remember that quoting simply prevents a list from being evaluated and instead treats it as data.

6. Symbols as data:
   Lisp allows us to use symbols (e.g. variable names) as data. They are created with the same quoting syntax as lists:
   

   'symbol

   Symbols are simply short strings, except they are case-insensitive (the REPL always prints them in uppercase) and cannot be changed or manipulated. Like with lists, quoting a symbol simply stops it from being evaluated (i.e. treated as a variable) and instead treats the symbol itself as data.
   Write a function that takes a keyword list, looks up the number called :test and returns the symbol YES if it is less than 10, and NO otherwise.
   

   ;; Example REPL session showing the concepts you need to use
   CL-USER> (setf x '(:x 10 :y 33 :test 9))
   (:X 10 :Y 33 :TEST 9)
   CL-USER> (getf x :test)
   9
   CL-USER> (> (getf x :test) 10)
   NIL
   CL-USER> (> 10 (getf x :test))
   T
   CL-USER> (if (> 10 (getf x :test))
   	     'SMALLER
   	     'BIGGER)
   SMALLER

7. Loading files:
   Typing things into the REPL every time is of course not the way we usually use Lisp. Instead we load a file with definitions of functions and variables, and then use the REPL to invoke them.
   • Start by downloading this file (right click “raw” and choose save as) and name the file agents.lisp. Save it in a folder for this lab session.
   • In the REPL, type , (comma); this invokes the command mode of the REPL, type the command cd and press enter. Emacs will prompt you for a file path, enter the file path to the folder where you saved the file.
   • Now type (in the REPL) the expression (load “agents.lisp”).
   • Now the definitions of the file have been loaded in the REPL. To see what definitions are available, open the file in the upper half of Emacs. To do this, you can click in the upper half and then press (in sequence) Cmd+C and Cmd+F and type the path to the file. Alternatively just select “File → Open”