Clojure Core

Namespaces

clojure
- core
  - protocols
- inspector
- java
  - browse
  - io
  - javadoc
  - shell
- main
- pprint
- repl
- set
- stacktrace
- string
- template
- test
  - junit
  - tap
- walk
- xml
- zip

You're viewing version 1.2.0 of future-done?. The latest stable version of Clojure Core is 1.3.0.

doc source examples comments

1.2.0

1.2.0
1.3.0

future-done?

clojure.core

(future-done? f)

Returns true if future f is done

© Rich Hickey. All rights reserved. Eclipse Public License 1.0

2 Examples top

link | changes
```
user=> (def f (future (Thread/sleep 5000) (inc 0)))

user=> (future-done? f)                            
false

user=> (Thread/sleep 5000)
nil

user=> (future-done? f)
true
```
user=> (def f (future (Thread/sleep 5000) (inc 0))) user=> (future-done? f) false user=> (Thread/sleep 5000) nil user=> (future-done? f) true
link | changes
```
;; beware of cancellation !!!

user=> (def f (future (Thread/sleep 5000) (inc 0)))
#'user/f

user=> (future-cancel f)                           
true

user=> (future-cancelled? f)                       
true

user=> (future-done? f)                            
true

user=> @f                                          
java.util.concurrent.CancellationException (NO_SOURCE_FILE:0)
```
;; beware of cancellation !!! user=> (def f (future (Thread/sleep 5000) (inc 0))) #'user/f user=> (future-cancel f) true user=> (future-cancelled? f) true user=> (future-done? f) true user=> @f java.util.concurrent.CancellationException (NO_SOURCE_FILE:0)

Log in to add / edit an example.

See Also top

1
clojure.core/future
Takes a body of expressions and yields a future object that will in
0
clojure.core/future?
Returns true if x is a future
0
clojure.core/future-cancel
Cancels the future, if possible.
0
clojure.core/future-cancelled?
Returns true if future f is cancelled

Log in to add a see also.

Source clojure/core.clj:5240 top

(defn future-done?
  "Returns true if future f is done"
  {:added "1.1"}
  [^java.util.concurrent.Future f] (.isDone f))

© Rich Hickey. All rights reserved. Eclipse Public License 1.0

Vars in clojure.core/future-done?: defn

Used in 0 other vars

Comments top

1 comment(s) for future-done?.

pauldoo

link

Future "done" returns true even for abnormal termination like being cancelled or throwing an exception.

http://download.oracle.com/javase/6/docs/api/java/util/concurrent/Future.html#isDone()

Log in to add a comment.