clojure.core/send

View this page on ClojureDocs

Type: function Added: Clojure 1.0 Examples: 2 Runnable: 0

([a f & args])

Dispatch an action to an agent. Returns the agent immediately. Subsequently, in a thread from a thread pool, the state of the agent will be set to the value of:

(apply action-fn state-of-agent args)

Examples

by gstamp on 2010-08-24 . May have evaluation errors. ▶

(def my-agent (agent 100)) #'user/my-agent @my-agent 100 ;; Note the following happens asynchronously in a thread ;; pool (send my-agent + 100) #<Agent@5afc0f5: 200> ;; Assuming the addition has completed the value will ;; now be updated when we look at it. @my-agent 200

by elect000 on 2017-10-24 . May have evaluation errors. ▶

;; update agent value (def foo (agent 100)) #'user/my-agent @foo 100 ;; function get "old value" (send foo (fn [old-foo] (println old-foo "foo will change") (+ old-foo 100))) 100 foo will change #agent[{:status :ready, :val 200} 0x000000] @foo 200

Note by fordsfords

See "send-off" for the differences between "send" and "send-off".

See also

• clojure.core/shutdown-agents (0)
• clojure.core/send-off (1)
• clojure.core/agent

---

Content from the matching ClojureDocs page, with authors credited on each contribution.