How does Clojure state work?

Question

I know what state is by concept, but I can't understand how it's been implemented in this example: https://github.com/quil/quil/blob/master/examples/gen_art/31_oo_circles.clj

I just simply don't see it. State implementation happens on lines 100, 109, and 137:

98-100:

(defn mouse-released []
  (add-circles (state :circles)))

109:

(set-state! :circles circles*)

135-140:

(defn draw []
  (background 255)
  (let [circles* (state :circles)
        circles (swap! circles* update-circles)]
    (doseq [c circles]
      (draw-circle c))))

What is happening on those lines?

set-state! is a Quil method, its implementation can be found at https://github.com/quil/quil/wiki/set~state%21

in this context "state" is the name of a var (not the most creative name in my opinion, but it gets the point across) — Arthur Ulfeldt, Mar 26 '13 at 18:59

Arthur Ulfeldt · Accepted Answer · 2013-03-26T18:57:15.917

3

the short answer: it's using an atom defined in applet.clj

It's a function defined in core.clj on line 17 which extracts state information stored as an atom attached to the metadata on the applet. Set state start by finding the atom that stored the current "state" by calling (:state (meta (current-applet)) which extracts the metadata (which is a map) form the applet object, then returns the atom stored in the :state key. It then calls reset! to put a new value in this atom. It gets included by the (:use quil.core) in the ns declaration.

edited Mar 26 '13 at 18:57

answered Mar 26 '13 at 18:26

Arthur Ulfeldt

90,827
27
201
284

I know set-state is coming from Quil but my question is what does exactly setting the state means/do? – Ricardo Sanchez Mar 26 '13 at 18:41

How does Clojure state work?

1 Answers1