Introduction to Clojure

Getting started with the latest Lisp dialect

Clojure is a Lisp-dialect which runs on the Java Virtual Machine (JVM). It is a dynamic programming language intended for general-purpose use. It also provides easy access to the Java standard library functions. In this introduction, we show you how to get started with Clojure.

Clojure is quite easy to install. The main requirement is a recent Java Virtual Machine (JVM) - 1.5 or later. You can download Clojure from the project download page at The latest released version is

You can find a file called clojure-1.0.0.jar inside the zip file which contains the Clojure libraries. That file is all you need to get started. A key feature of Clojure is its shell-like interface, called the read-eval-print loop (or REPL), which you can start as follows:

java -cp clojure-1.0.0.jar clojure.lang.Repl

You will then get a "user=>" prompt which you can use to type commands for evaluation. For example, you can do basic arithmetic:

user=> (+ 1 2)
user=> (/ 8 2)

Note the order of the operands:

user=> (- 8 2)
user=> (- 2 8)

You can also do nesting:

user=> (* (+ 2 2) 8)

Or use multiple arguments:

user=> (+ 1 2 3 4 5)

The examples above are written in a form known as a S-expression, which is similar to all forms of LISP. The basic structure of an S-expression is:

(function arg1 arg2 ...)

There are several pre-built functions that you can use as building blocks. For example you can check whether two values are equal using the "=" function:

user=> (= 1 2)
user=> (= 1 1)

Boolean arithmetic can be done through the ‘or’, ‘and’ and ‘not’ functions:

user=> (and true true)
user=> (and true false)
user=> (or true false)
user=> (or false false)
user=> (not true)

With these building blocks, you can now write your own functions:

(defn factorial [n]
    (if (<= n 1)
        (* n (factorial (- n 1)))
user=> (factorial 0)
user=> (factorial 1)
user=> (factorial 3)

You may have noticed there's a problem in the above function. Giving it a negative number as an argument will cause a stack overflow. We can solve it by using Exceptions:

(defn factorial [n]
    (if (< n 0)
        (throw (Exception. "Can't find the factorial of a negative number")))
    (if (<= n 0)
        (* n (factorial (dec n)))
user=> (factorial -3)
java.lang.Exception: Can't find the factorial of a negative number (NO_SOURCE_FILE:0)

A similar example is a function to find the nth number in the Fibonacci number series:

(defn fibonacci [n]
        (or (= n 1) (= n 2))
        (+ (fibonacci (- n 1)) (fibonacci (- n 2)))
user=> (fibonacci 1)
user=> (fibonacci 2)
user=> (fibonacci 3)
user=> (fibonacci 4)
user=> (fibonacci 5)

What if we wanted to view the first 10 numbers? We can create a lambda function, by using the "map" and "fn" functions:

user=> (map (fn [x] (fibonacci x)) [1 2 3 5 6 7 8 9 10])
(1 1 2 5 8 13 21 34 55)

For those of you have been hanging out for a "Hello World" example: you can do that quite simply:

user=> (println "Hello, world")
Hello, world

And one last example:

user=> (. System/out (println "Hello, world!"))
Hello, world!

Since Clojure runs on the JVM, it's also possible to access the standard Java library from Clojure code. The example above is the Clojure equivalent of this Java code:

System.out.println("Hello, world!")

We've only covered a small fraction of Clojure, but it should be enough to get you started. To learn more, check out the Clojure getting started page (and the links in the reference section, as well as Clojure wikibook.

Join the newsletter!


Sign up to gain exclusive access to email subscriptions, event invitations, competitions, giveaways, and much more.

Membership is free, and your security and privacy remain protected. View our privacy policy before signing up.

Error: Please check your email address.

Tags a-z of programming languagesprogramminglisp

Show Comments