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 contains?. The latest stable version of Clojure Core is 1.3.0.

1.2.0

1.2.0
1.3.0

contains?

Returns true if key is present in the given collection, otherwise
returns false. Note that for numerically indexed collections like
vectors and Java arrays, this tests if the numeric key is within the
range of indexes. 'contains?' operates constant or logarithmic time;
it will not perform a linear search for a value. See also 'some'.

2 Examples top

link | changes
```
;; `contains?` is straightforward for maps:
user=> (contains? {:a 1} :a)
true
user=> (contains? {:a nil} :a)
true
user=> (contains? {:a 1} :b)
false


;; It's likely to surprise you for other sequences because it's 
;; about *indices*, not *contents*:

user=> (contains? [:a :b :c] :b)
false

user=> (contains? [:a :b :c] 2)
true

user=> (contains? "f" 0)
true

user=> (contains? "f" 1)
false


;; It can be applied to non-sequences:

user=> (contains? 5 3)
false


;; Although lists are sequences, `contains?` seems to always return
;; `false` for them. (Clojure 1.1)

user=> (contains? '(1 2 3) 1) => false
```
;; `contains?` is straightforward for maps: user=> (contains? {:a 1} :a) true user=> (contains? {:a nil} :a) true user=> (contains? {:a 1} :b) false ;; It's likely to surprise you for other sequences because it's ;; about *indices*, not *contents*: user=> (contains? [:a :b :c] :b) false user=> (contains? [:a :b :c] 2) true user=> (contains? "f" 0) true user=> (contains? "f" 1) false ;; It can be applied to non-sequences: user=> (contains? 5 3) false ;; Although lists are sequences, `contains?` seems to always return ;; `false` for them. (Clojure 1.1) user=> (contains? '(1 2 3) 1) => false
link | changes
```
;; Can be used to test set membership
user=> (def s #{"a" "b" "c"})

user=> (contains? s "a")
true

user=> (contains? s "z")
false
```
;; Can be used to test set membership user=> (def s #{"a" "b" "c"}) user=> (contains? s "a") true user=> (contains? s "z") false

Source clojure/core.clj:1145 top

(defn contains?
  "Returns true if key is present in the given collection, otherwise
  returns false.  Note that for numerically indexed collections like
  vectors and Java arrays, this tests if the numeric key is within the
  range of indexes. 'contains?' operates constant or logarithmic time;
  it will not perform a linear search for a value.  See also 'some'."
  {:added "1.0"}
  [coll key] (. clojure.lang.RT (contains coll key)))

Vars in clojure.core/contains?: defn key

Comments top

2 comment(s) for contains?.

robertpostill

link

If like me you wanted to find a value in a collection and read this article then you'll need to find an alternative. So instead of:

(contains (1 2 3) 1)

I used:

(some #(= 1 %) (1 2 3))

Hope that helps.

If like me you wanted to find a value in a collection and read this article then you'll need to find an alternative. So instead of:

(contains (1 2 3) 1)

I used:

(some #(= 1 %) (1 2 3))

Hope that helps.

devijvers

link

For collections I use the java.util.Collection#contains() method:

user=> (.contains [1 2 3] 1)
true
user=> (.contains [1 2 3] 4)
false

For collections I use the `java.util.Collection#contains()` method:

user=> (.contains [1 2 3] 1)
true
user=> (.contains [1 2 3] 4)
false

ClojureDocs(beta)