This tutorial introduces the programming language, Clojure. Clojure is an awesome functional programming language that runs on Java’s Virtual Machine (JVM). It is sometimes called a LISP, which is short for ‘LISt Processing’.
You’ll need to have some previous programming experience in another language to get the most out of this tutorial. Clojure is so different from most imperative programming languages that it doesn’t really matter where you are coming from as long as you know the basics (variables, if statements, loops, and functions).
If you are looking for a complete beginner’s guide to programming, you can find some of my other programming content below.
Here, I will cover functions, data structures, immutability, closures, tail recursion, lazy sequences, macros, and concurrency.
Clojure is a functional programming language. In it, the function is king and data is immutable. This may be a different paradigm than you are used to, but there are some compelling reasons to use it. Clojure’s immutability is particularly good for programs that need to take advantage of modern hardware on laptops and mobile phones (multiple processors sharing a single memory).
Clojure runs on the JVM. It can be difficult to set up Clojure because it involves installing Java, Leiningen, and sometimes an editor plugin. To make things easier, I recommend starting with a web-based IDE. There is no easier way to start programming in Clojure than using replit. I recommend using it to write your first programs in Clojure. If you feel up to it, check out these docs to get started on your own machine.
Even if you don’t use Clojure every day, learning it will change how you think about programming. It will help you understand recursion, higher-order functions, and data transformations in a new way. These ideas transfer well to other languages like JavaScript, Python, or Rust. In short, learning Clojure will make you a better programmer.
Code Playbacks
This material will not be delivered like traditional online tutorials or video series. Each section includes links to interactive code playbacks that visually animate changes made to a program in a step-by-step manner, helping you understand how it was written.
A code playback shows how a program evolves by replaying all the steps in its development. It has an author-supplied narrative, screenshots, whiteboard-style drawings, and self-grading multiple choice questions to make the learning process more dynamic and interactive.
Here’s a short YouTube video explaining how to view a code playback:
Playback Press
Playback Press is a platform for sharing interactive code walkthroughs that I created. I’m Mark, by the way, a professor of computer science. These books provide interactive programming lessons through step-by-step animations, AI tutoring, and quizzes.
If you want to see the full Clojure ‘book’, you can go here:
An Animated Introduction to Clojure, by Mark Mahoney
I also built Storyteller, the free and open-source tool that powers code playbacks.
AI Tutor
When viewing a code playback, you can ask an AI tutor about the code. It answers questions clearly and patiently, making it a helpful resource for learners. You can also ask the AI tutor to generate new self-grading multiple-choice questions to test your knowledge of what you are learning.
To access the AI tutor and self-grading quizzes, simply create a free account on Playback Press and add the book to your bookshelf.
Table of Contents
Introduction to Clojure
These first few programs show how to print to the screen, perform basic arithmetic, and store some data. Go through each of these now:
This program shows how to use the Java capability that it built into to the JVM.
These programs show some basic data structures in Clojure and how they are immutable.
Hands-On Practice
Problem 1
Write a Clojure program that prompts the user for the length and width of a wooden board in inches. Then display the number of whole square feet that are in the board. For example, if the height is 27 inches and the width is 34 inches, then the number of square feet is 6.375.
Problem 2
Write a program that creates an empty list and use def to store a reference to it called empty-list. Use cons to add your name to it and store it in a new list called my-name.
Use conj to add all of your siblings to a list called me-and-my-siblings (if you don’t have any or don’t have that many you can use some of the Kardashians).
Print all the names in me-and-my-siblings. Then print the third name on the list me-and-my-siblings.
Create a map with all of your siblings’ names as keys and their birth years as values. Use assoc to add your name and birth year to the map. Use the map to print everyone’s name and their age in the year 2050.
Problem 3
Create a map with the number of days in each of the months called days-in-months. Use Clojure keywords like :jan and :feb as the keys and the number of days in the months as the values.
Create a second map from the first that has 29 days for February. Call this one days-in-months-leapyear. Make sure to do this efficiently, use assoc to create a new value for February. Finally, print each of the maps.
Functions
Next, I’ll discuss creating and calling functions in Clojure. Clojure is a functional programming language so this is a pretty important topic.
The first two programs show how to write functions in Clojure.
This program shows how to use a map to encapsulate data along with some functions that manipulate the data.
These programs show how to read and write to a file using functions.
Hands-On Practice
Problem 1
Write three mathematical functions:
-
squaresquares a passed in parameter -
cubecubes a passed in parameter -
powraises a base number to an exponent
For this group of functions, do not use any built-in mathematical functions.
Hint: look at the Clojure function repeat and reduce for the pow function. Use the let function to hold temporary values so that they can be referred to later.
Problem 2
Write a function that takes a number and will calculate the factorial value for that number.
<span class="hljs-number">5</span>! is <span class="hljs-number">5</span> * <span class="hljs-number">4</span> * <span class="hljs-number">3</span> * <span class="hljs-number">2</span> * <span class="hljs-number">1</span> = <span class="hljs-number">120</span>
<span class="hljs-number">10</span>! is <span class="hljs-number">10</span> * <span class="hljs-number">9</span> * <span class="hljs-number">8</span> * <span class="hljs-number">7</span> * <span class="hljs-number">6</span> * <span class="hljs-number">5</span> * <span class="hljs-number">4</span> * <span class="hljs-number">3</span> * <span class="hljs-number">2</span> * <span class="hljs-number">1</span> = <span class="hljs-number">3</span>,<span class="hljs-number">628</span>,<span class="hljs-number">800</span>
Hint: this type of problem is typically done with recursion. But for now, try to do it without recursion. Look at the Clojure range and reduce functions.
Problem 3
Write a function that determines whether a number is prime or not. Use the range and filter functions to filter out non-primes in a range of values.
Hint: look at the not-any? and mod functions for determining whether a number is prime or not.
Problem 4
Write a function that takes one or more string parameters, converts them to numbers, and then adds them together and returns the sum.
(println (add-strings <span class="hljs-string">"10"</span>)) ;prints <span class="hljs-number">10</span>
(println (add-strings <span class="hljs-string">"10"</span> <span class="hljs-string">"20"</span>)) ;prints <span class="hljs-number">30</span>
(println (add-strings <span class="hljs-string">"10"</span> <span class="hljs-string">"20"</span> <span class="hljs-string">"30"</span>)) ;prints <span class="hljs-number">60</span>
(println (add-strings <span class="hljs-string">"10"</span> <span class="hljs-string">"20"</span> <span class="hljs-string">"30"</span> <span class="hljs-string">"40"</span>)) ;prints <span class="hljs-number">100</span>
Use Clojure’s reduce function or apply to turn the strings into numbers and then add them together.
Closures
A closure is a way to associate data permanently with a function.
The first program shows how to bind data to a function.
The second program shows a more complex example of using closures.
Hands-On Practice
Problem 1
Write a function that returns a function. The Fibonacci numbers are a sequence of numbers that are generated by summing the previous two numbers together:
<span class="hljs-number">0</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">5</span> <span class="hljs-number">8</span> <span class="hljs-number">13</span> <span class="hljs-number">21</span> <span class="hljs-number">34</span> ...
Usually, the first two numbers are assumed to be 0 and 1. But in this case, return a function that uses the specified first two numbers in the sequence. Then generate and print out the requested numbers in the sequence.
(defn fibs-fn[firstFib secondFib] ...) ;;<span class="hljs-function">fill <span class="hljs-keyword">this</span> <span class="hljs-title">in</span>
<span class="hljs-params">(def another-fib (fibs-fn <span class="hljs-number">10</span> <span class="hljs-number">15</span>))</span> </span>;;create a fib function that prints starting with <span class="hljs-number">10</span> <span class="hljs-keyword">and</span> <span class="hljs-number">15</span>
(another-fib <span class="hljs-number">5</span>) ;;print first <span class="hljs-number">5</span> fibs: <span class="hljs-number">10</span> <span class="hljs-number">15</span> <span class="hljs-number">25</span> <span class="hljs-number">40</span> <span class="hljs-number">65</span>
Recursion
A recursive function is one that calls itself. Since every function call results in a stack frame being placed on the call stack, regular recursion runs the risk of ‘blowing up the call stack’. Tail recursion, with recur, is an efficient way to simulate recursion without the downsides.
Hands-On Practice
Problem 1
Write a recursive function to reverse the letters of a string.
(reverse-<span class="hljs-built_in">string</span> <span class="hljs-string">"Mark Mahoney"</span>) ;;returns <span class="hljs-string">"yenohaM kraM"</span>
You may need to create a recursive ‘helper’ function that takes a different number of parameters than the non-recursive function or use the loop form. Make sure you use recursion with the recur form so that you do not ‘blow the stack’.
Problem 2
Write a function that will join a series of strings together separated by another string. The function should create and return a new string. Use recursion with recur.
(defn join [separator & parts]
;;your code here)
(join <span class="hljs-string">", "</span> <span class="hljs-string">"Mark"</span> <span class="hljs-string">"Laura"</span> <span class="hljs-string">"Buddy"</span> <span class="hljs-string">"Patrick"</span> <span class="hljs-string">"Willy"</span>) ;;<span class="hljs-string">"Mark, Laura, Buddy, Patrick, Willy"</span>
Problem 3
Write a function that takes in an integer and converts it to a string. The user can specify the base that the string is in from 2-10. The program should use recursion and recur (either a recursive function or the loop form).
(to-<span class="hljs-built_in">string</span> <span class="hljs-number">100</span> <span class="hljs-number">10</span>) ;;<span class="hljs-string">"100"</span> decimal
(to-<span class="hljs-built_in">string</span> <span class="hljs-number">7</span> <span class="hljs-number">2</span>) ;;<span class="hljs-string">"111"</span> binary
Lazy Sequences
A lazy sequence defers the cost of creating values until they are needed. The first program shows how to create a lazy sequence. The next two are more concrete examples.
Hands-On Practice
Problem 1
Create a function that generates a lazy sequence of squares. For example, (1 4 9 16 … to infinity). Use it to print the first 10 squared values.
Then write a function that generates a lazy sequence of values raised to a power:
(defn lazy-<span class="hljs-built_in">pow</span> [start-val power]
...)
(take <span class="hljs-number">6</span> (lazy-<span class="hljs-built_in">pow</span> <span class="hljs-number">10</span> <span class="hljs-number">2</span>)) ;(<span class="hljs-number">100</span> <span class="hljs-number">121</span> <span class="hljs-number">144</span> <span class="hljs-number">169</span> <span class="hljs-number">196</span> <span class="hljs-number">225</span>)
(take <span class="hljs-number">6</span> (lazy-<span class="hljs-built_in">pow</span> <span class="hljs-number">10</span> <span class="hljs-number">3</span>)) ;(<span class="hljs-number">1000</span> <span class="hljs-number">1331</span> <span class="hljs-number">1728</span> <span class="hljs-number">2197</span> <span class="hljs-number">2744</span> <span class="hljs-number">3375</span>)
Problem 2
Write a function that generates an infinite lazy sequence of possible permutations of the passed in sequence.
(take <span class="hljs-number">3</span> (lazy-perm [<span class="hljs-string">"a"</span> <span class="hljs-string">"b"</span> <span class="hljs-string">"c"</span>]))
;(<span class="hljs-string">"a"</span> <span class="hljs-string">"b"</span> <span class="hljs-string">"c"</span>)
(take <span class="hljs-number">12</span> (lazy-perm [<span class="hljs-string">"a"</span> <span class="hljs-string">"b"</span> <span class="hljs-string">"c"</span>]))
;(<span class="hljs-string">"a"</span> <span class="hljs-string">"b"</span> <span class="hljs-string">"c"</span> <span class="hljs-string">"aa"</span> <span class="hljs-string">"ab"</span> <span class="hljs-string">"ac"</span> <span class="hljs-string">"ba"</span> <span class="hljs-string">"bb"</span> <span class="hljs-string">"bc"</span> <span class="hljs-string">"ca"</span> <span class="hljs-string">"cb"</span> <span class="hljs-string">"cc"</span>)
(take <span class="hljs-number">39</span> (lazy-perm [<span class="hljs-string">"a"</span> <span class="hljs-string">"b"</span> <span class="hljs-string">"c"</span>]))
;(<span class="hljs-string">"a"</span> <span class="hljs-string">"b"</span> <span class="hljs-string">"c"</span> <span class="hljs-string">"aa"</span> <span class="hljs-string">"ab"</span> <span class="hljs-string">"ac"</span> <span class="hljs-string">"ba"</span> <span class="hljs-string">"bb"</span> <span class="hljs-string">"bc"</span> <span class="hljs-string">"ca"</span> <span class="hljs-string">"cb"</span> <span class="hljs-string">"cc"</span> <span class="hljs-string">"aaa"</span> <span class="hljs-string">"aab"</span> <span class="hljs-string">"aac"</span> <span class="hljs-string">"aba"</span> <span class="hljs-string">"abb"</span> <span class="hljs-string">"abc"</span> <span class="hljs-string">"aca"</span> <span class="hljs-string">"acb"</span> <span class="hljs-string">"acc"</span> <span class="hljs-string">"baa"</span> <span class="hljs-string">"bab"</span> <span class="hljs-string">"bac"</span> <span class="hljs-string">"bba"</span> <span class="hljs-string">"bbb"</span> <span class="hljs-string">"bbc"</span> <span class="hljs-string">"bca"</span> <span class="hljs-string">"bcb"</span> <span class="hljs-string">"bcc"</span> <span class="hljs-string">"caa"</span> <span class="hljs-string">"cab"</span> <span class="hljs-string">"cac"</span> <span class="hljs-string">"cba"</span> <span class="hljs-string">"cbb"</span> <span class="hljs-string">"cbc"</span> <span class="hljs-string">"cca"</span> <span class="hljs-string">"ccb"</span> <span class="hljs-string">"ccc"</span>)
(take <span class="hljs-number">120</span> (lazy-perm [<span class="hljs-string">"a"</span> <span class="hljs-string">"b"</span> <span class="hljs-string">"c"</span>]))
;(<span class="hljs-string">"a"</span> <span class="hljs-string">"b"</span> <span class="hljs-string">"c"</span> <span class="hljs-string">"aa"</span> <span class="hljs-string">"ab"</span> <span class="hljs-string">"ac"</span> <span class="hljs-string">"ba"</span> <span class="hljs-string">"bb"</span> <span class="hljs-string">"bc"</span> <span class="hljs-string">"ca"</span> <span class="hljs-string">"cb"</span> <span class="hljs-string">"cc"</span> <span class="hljs-string">"aaa"</span> <span class="hljs-string">"aab"</span> <span class="hljs-string">"aac"</span> <span class="hljs-string">"aba"</span> <span class="hljs-string">"abb"</span> <span class="hljs-string">"abc"</span> <span class="hljs-string">"aca"</span> <span class="hljs-string">"acb"</span> <span class="hljs-string">"acc"</span> <span class="hljs-string">"baa"</span> <span class="hljs-string">"bab"</span> <span class="hljs-string">"bac"</span> <span class="hljs-string">"bba"</span> <span class="hljs-string">"bbb"</span> <span class="hljs-string">"bbc"</span> <span class="hljs-string">"bca"</span> <span class="hljs-string">"bcb"</span> <span class="hljs-string">"bcc"</span> <span class="hljs-string">"caa"</span> <span class="hljs-string">"cab"</span> <span class="hljs-string">"cac"</span> <span class="hljs-string">"cba"</span> <span class="hljs-string">"cbb"</span> <span class="hljs-string">"cbc"</span> <span class="hljs-string">"cca"</span> <span class="hljs-string">"ccb"</span> <span class="hljs-string">"ccc"</span> <span class="hljs-string">"aaaa"</span> <span class="hljs-string">"aaab"</span> <span class="hljs-string">"aaac"</span> <span class="hljs-string">"aaba"</span> <span class="hljs-string">"aabb"</span> <span class="hljs-string">"aabc"</span> <span class="hljs-string">"aaca"</span> <span class="hljs-string">"aacb"</span> <span class="hljs-string">"aacc"</span> <span class="hljs-string">"abaa"</span> <span class="hljs-string">"abab"</span> <span class="hljs-string">"abac"</span> <span class="hljs-string">"abba"</span> <span class="hljs-string">"abbb"</span> <span class="hljs-string">"abbc"</span> <span class="hljs-string">"abca"</span> <span class="hljs-string">"abcb"</span> <span class="hljs-string">"abcc"</span> <span class="hljs-string">"acaa"</span> <span class="hljs-string">"acab"</span> <span class="hljs-string">"acac"</span> <span class="hljs-string">"acba"</span> <span class="hljs-string">"acbb"</span> <span class="hljs-string">"acbc"</span> <span class="hljs-string">"acca"</span> <span class="hljs-string">"accb"</span> <span class="hljs-string">"accc"</span> <span class="hljs-string">"baaa"</span> <span class="hljs-string">"baab"</span> <span class="hljs-string">"baac"</span> <span class="hljs-string">"baba"</span> <span class="hljs-string">"babb"</span> <span class="hljs-string">"babc"</span> <span class="hljs-string">"baca"</span> <span class="hljs-string">"bacb"</span> <span class="hljs-string">"bacc"</span> <span class="hljs-string">"bbaa"</span> <span class="hljs-string">"bbab"</span> <span class="hljs-string">"bbac"</span> <span class="hljs-string">"bbba"</span> <span class="hljs-string">"bbbb"</span> <span class="hljs-string">"bbbc"</span> <span class="hljs-string">"bbca"</span> <span class="hljs-string">"bbcb"</span> <span class="hljs-string">"bbcc"</span> <span class="hljs-string">"bcaa"</span> <span class="hljs-string">"bcab"</span> <span class="hljs-string">"bcac"</span> <span class="hljs-string">"bcba"</span> <span class="hljs-string">"bcbb"</span> <span class="hljs-string">"bcbc"</span> <span class="hljs-string">"bcca"</span> <span class="hljs-string">"bccb"</span> <span class="hljs-string">"bccc"</span> <span class="hljs-string">"caaa"</span> <span class="hljs-string">"caab"</span> <span class="hljs-string">"caac"</span> <span class="hljs-string">"caba"</span> <span class="hljs-string">"cabb"</span> <span class="hljs-string">"cabc"</span> <span class="hljs-string">"caca"</span> <span class="hljs-string">"cacb"</span> <span class="hljs-string">"cacc"</span> <span class="hljs-string">"cbaa"</span> <span class="hljs-string">"cbab"</span> <span class="hljs-string">"cbac"</span> <span class="hljs-string">"cbba"</span> <span class="hljs-string">"cbbb"</span> <span class="hljs-string">"cbbc"</span> <span class="hljs-string">"cbca"</span> <span class="hljs-string">"cbcb"</span> <span class="hljs-string">"cbcc"</span> <span class="hljs-string">"ccaa"</span> <span class="hljs-string">"ccab"</span> <span class="hljs-string">"ccac"</span> <span class="hljs-string">"ccba"</span> <span class="hljs-string">"ccbb"</span> <span class="hljs-string">"ccbc"</span> <span class="hljs-string">"ccca"</span> <span class="hljs-string">"cccb"</span> <span class="hljs-string">"cccc"</span>)
Macros
A macro specifies some code to be executed, sort of like a function, but it also allows some of that code to be replaced with values that come from the user.
The code in a macro is kind of like a template that can be altered to suit the caller’s needs. With this powerful feature, the language can be expanded to do things that the language inventor never thought to add.
Hands-On Practice
Problem 1
Write a macro that takes in a grade earned on a student assignment (on a 0-100 scale) and some code to execute if the grade is a passing or failing.
(defmacro eval-grade [grade <span class="hljs-keyword">if</span>-passing <span class="hljs-keyword">if</span>-failing] ...)
And use it to print or call a function based on the value of the grade
(def users-grade <span class="hljs-number">43</span>)
(eval-grade users-grade (println <span class="hljs-string">"Passing"</span>) (println <span class="hljs-string">"Failing"</span>)) ;;<span class="hljs-string">"Failing"</span>
(eval-grade users-grade (praise users-grade) (warning users-grade)) ;;call the warning function
Concurrency
Concurrency in Clojure is a big topic. I start by discussing threads. Then I talk about different strategies for dealing with data that is shared among different threads.
Hands-On Practice
Problem 1
This lab asks you to create a Clojure program that will count how many primes are in a given range.
Create a thread pool and have each thread check a single number in the range. If it finds a prime, it will increase a counter (which should be an atom since it is shared by all of the threads). Look at the program above on Atoms as a starting point.
Conclusion
If you’ve made it this far, you’ve already taken meaningful steps toward learning a language that can change how you write and think about code.
Clojure offers a fresh perspective on programming, one that focuses on simplicity, immutability, and the power of functions. Learning Clojure will change your brain and you will take these lessons with you to other languages as well.
So keep experimenting, keep asking questions, and keep practicing to sharpen your skills.
Comments and Feedback
You can find all of these code playbacks in the free ‘book’, An Animated Introduction to Clojure. There are more free books here:
Comments and feedback are welcome via email: mark@playbackpress.com.
Source: freeCodeCamp Programming Tutorials: Python, JavaScript, Git & MoreÂ
