store/[org.clojure/clojure "1.8.0"] clj::clojure.core/send-off

Official Documentation

Add notes
Arities
==================================================
   [a f & args]

Docstring
==================================================
  Dispatch a potentially blocking action to an agent. Returns the
  agent immediately. Subsequently, in a separate thread, the state of
  the agent will be set to the value of:

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

Source

(defn send-off
  "Dispatch a potentially blocking action to an agent. Returns the
  agent immediately. Subsequently, in a separate thread, the state of
  the agent will be set to the value of:

  (apply action-fn state-of-agent args)"
  {:added "1.0"
   :static true}
  [^clojure.lang.Agent a f & args]
  (apply send-via clojure.lang.Agent/soloExecutor a f args))

Example 1

Edit
(def my-agent (agent ""))
;; => #'user/my-agent

@my-agent
;; => ""

;; Note the following happens asynchronously in a thread
;; pool
(send my-agent #(slurp %2) "file.txt")
;; => #<Agent@13c6641: "">

;; Assuming the action has been invoked the value will
;; now be updated when we look at it.
@my-agent
;; => "file contents"

Uses on crossclj