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

1.2.0

1.2.0
1.3.0

use

Like 'require, but also refers to each lib's namespace using
clojure.core/refer. Use :use in the ns macro in preference to calling
this directly.

'use accepts additional options in libspecs: :exclude, :only, :rename.
The arguments and semantics for :exclude, :only, and :rename are the same
as those documented for clojure.core/refer.

3 Examples top

link | changes
```
;; Use the namespace clojure.java.io:
user=> (use '(clojure.java io))
```
;; Use the namespace clojure.java.io: user=> (use '(clojure.java io))
link | changes
```
;; Imports only the split function from clojure.string.
user=> (use '[clojure.string :only (split)])
nil

;; split is now available without a namespace qualification.
user=> (split "hello world" #" ")
["hello" "world"]

;; You can also add the :as keyword to import the rest of clojure.string
;; with a namespace qualification.
user=> (use '[clojure.string :as s :only (split)])
nil

;; Now we can access any function in clojure.string using s.
user=> (s/replace "foobar" "foo" "squirrel")
"squirrelbar"

;; And we can still call split with or without the s qualification.
user=> (split "hello world" #" ")
["hello" "world"]
user=> (s/split "hello world" #" ")
["hello" "world"]
```
;; Imports only the split function from clojure.string. user=> (use '[clojure.string :only (split)]) nil ;; split is now available without a namespace qualification. user=> (split "hello world" #" ") ["hello" "world"] ;; You can also add the :as keyword to import the rest of clojure.string ;; with a namespace qualification. user=> (use '[clojure.string :as s :only (split)]) nil ;; Now we can access any function in clojure.string using s. user=> (s/replace "foobar" "foo" "squirrel") "squirrelbar" ;; And we can still call split with or without the s qualification. user=> (split "hello world" #" ") ["hello" "world"] user=> (s/split "hello world" #" ") ["hello" "world"]
link | changes
```
(ns some.namespace
  (:require [clojure.contrib.json :as json])
  (:use [clojure.string :only [trim lower-case split]]
        [clojure.contrib.shell-out]
        [clojure.pprint]
        [clojure.test]))
```
(ns some.namespace (:require [clojure.contrib.json :as json]) (:use [clojure.string :only [trim lower-case split]] [clojure.contrib.shell-out] [clojure.pprint] [clojure.test]))

Source clojure/core.clj:4871 top

(defn use
  "Like 'require, but also refers to each lib's namespace using
  clojure.core/refer. Use :use in the ns macro in preference to calling
  this directly.

  'use accepts additional options in libspecs: :exclude, :only, :rename.
  The arguments and semantics for :exclude, :only, and :rename are the same
  as those documented for clojure.core/refer."
  {:added "1.0"}
  [& args] (apply load-libs :require :use args))

Vars in clojure.core/use: apply defn

Used in 1 other vars repl

Comments top

2 comment(s) for use.

gstamp

link

Good description of use/require/import here:

http://blog.8thlight.com/articles/2010/12/6/clojure-libs-and-namespaces-require-use-import-and-ns

vikbehal

link

http://blog.8thlight.com/colin-jones/2010/12/05/clojure-libs-and-namespaces-require-use-import-and-ns.html

ClojureDocs(beta)