This repository has been archived by the owner on May 3, 2024. It is now read-only.
forked from richhickey/clojure-contrib
/
def-api.html
313 lines (271 loc) · 19.3 KB
/
def-api.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
<html>
<head>
<title>def - clojure-contrib v1.1 API documentation</title>
<link href="../static/favicon.png" rel="icon" />
<link href="../static/favicon.png" rel="shortcut icon" />
<link media="all" type="text/css" href="../static/clojure.css" rel="stylesheet" />
<link media="all" type="text/css" href="../static/wiki.css" rel="stylesheet" />
<link media="all" type="text/css" href="../static/internal.css" rel="stylesheet" />
<style>.menuWrapper{height: 36px;}</style>
<!--[if lte IE 6]>
<link rel="stylesheet" href="http://www.wikispaces.com/_/2009051601/s/internal_ie.css" type="text/css" />
<![endif]-->
</head>
<!--
This document was auto-generated from the source by the clojure autodoc system.
To report errors or ask questions about the overall documentation structure, formatting,
etc., contact Tom Faulhaber (google mail name: tomfaulhaber).
For errors in the documentation of a particular namespace, contact the author of that
namespace.
-->
<body>
<div id="AllContentContainer">
<div id="Header">
<a id="Logo" href="index.html"><img alt="Clojure" height="100" width="100" src="../static/clojure-icon.gif" /></a>
<h1><a title="page header title" id="page-header" href="index.html">Clojure-contrib API Reference</a></h1>
</div>
<div id="leftcolumn"><div style="text-align: center;"></div>
<div class="menu">
<div class="WikiCustomNav WikiElement wiki">
<span class="toc-header"><span id="project-name">clojure-contrib</span> <span id="version">v1.1</span> API</span><br />
<ul>
<li><a class="wiki_link" href="index.html">Overview</a></li>
<li><a class="wiki_link" href="api-index.html">API Index</a></li>
</ul>
<span class="toc-header">Namespaces</span>
<ul id="left-sidebar-list">
<li><a href="accumulators-api.html" class="wiki_link">accumulators</a></li><li><a href="agent-utils-api.html" class="wiki_link">agent-utils</a></li><li><a href="apply-macro-api.html" class="wiki_link">apply-macro</a></li><li><a href="base64-api.html" class="wiki_link">base64</a></li><li><a href="classpath-api.html" class="wiki_link">classpath</a></li><li><a href="combinatorics-api.html" class="wiki_link">combinatorics</a></li><li><a href="command-line-api.html" class="wiki_link">command-line</a></li><li><a href="complex-numbers-api.html" class="wiki_link">complex-numbers</a></li><li><a href="cond-api.html" class="wiki_link">cond</a></li><li><a href="condition-api.html" class="wiki_link">condition</a></li><li><a href="core-api.html" class="wiki_link">core</a></li><li><a href="dataflow-api.html" class="wiki_link">dataflow</a></li><li><a href="datalog-api.html" class="wiki_link">datalog</a></li><li><a href="def-api.html" class="wiki_link">def</a></li><li><a href="duck-streams-api.html" class="wiki_link">duck-streams</a></li><li><a href="error-kit-api.html" class="wiki_link">error-kit</a></li><li><a href="except-api.html" class="wiki_link">except</a></li><li><a href="fcase-api.html" class="wiki_link">fcase</a></li><li><a href="find-namespaces-api.html" class="wiki_link">find-namespaces</a></li><li><a href="fnmap-api.html" class="wiki_link">fnmap</a></li><li><a href="gen-html-docs-api.html" class="wiki_link">gen-html-docs</a></li><li><a href="generic.arithmetic-api.html" class="wiki_link">generic.arithmetic</a></li><li><a href="generic.collection-api.html" class="wiki_link">generic.collection</a></li><li><a href="generic.comparison-api.html" class="wiki_link">generic.comparison</a></li><li><a href="generic.functor-api.html" class="wiki_link">generic.functor</a></li><li><a href="generic.math-functions-api.html" class="wiki_link">generic.math-functions</a></li><li><a href="graph-api.html" class="wiki_link">graph</a></li><li><a href="greatest-least-api.html" class="wiki_link">greatest-least</a></li><li><a href="http.agent-api.html" class="wiki_link">http.agent</a></li><li><a href="http.connection-api.html" class="wiki_link">http.connection</a></li><li><a href="import-static-api.html" class="wiki_link">import-static</a></li><li><a href="jar-api.html" class="wiki_link">jar</a></li><li><a href="java-utils-api.html" class="wiki_link">java-utils</a></li><li><a href="javadoc.browse-api.html" class="wiki_link">javadoc.browse</a></li><li><a href="jmx-api.html" class="wiki_link">jmx</a></li><li><a href="json.read-api.html" class="wiki_link">json.read</a></li><li><a href="json.write-api.html" class="wiki_link">json.write</a></li><li><a href="lazy-seqs-api.html" class="wiki_link">lazy-seqs</a></li><li><a href="lazy-xml-api.html" class="wiki_link">lazy-xml</a></li><li><a href="logging-api.html" class="wiki_link">logging</a></li><li><a href="macro-utils-api.html" class="wiki_link">macro-utils</a></li><li><a href="macros-api.html" class="wiki_link">macros</a></li><li><a href="map-utils-api.html" class="wiki_link">map-utils</a></li><li><a href="math-api.html" class="wiki_link">math</a></li><li><a href="miglayout-api.html" class="wiki_link">miglayout</a></li><li><a href="mmap-api.html" class="wiki_link">mmap</a></li><li><a href="mock-api.html" class="wiki_link">mock</a></li><li><a href="monadic-io-streams-api.html" class="wiki_link">monadic-io-streams</a></li><li><a href="monads-api.html" class="wiki_link">monads</a></li><li><a href="ns-utils-api.html" class="wiki_link">ns-utils</a></li><li><a href="pprint-api.html" class="wiki_link">pprint</a></li><li><a href="probabilities.finite-distributions-api.html" class="wiki_link">probabilities.finite-distributions</a></li><li><a href="probabilities.monte-carlo-api.html" class="wiki_link">probabilities.monte-carlo</a></li><li><a href="probabilities.random-numbers-api.html" class="wiki_link">probabilities.random-numbers</a></li><li><a href="profile-api.html" class="wiki_link">profile</a></li><li><a href="prxml-api.html" class="wiki_link">prxml</a></li><li><a href="repl-ln-api.html" class="wiki_link">repl-ln</a></li><li><a href="repl-utils-api.html" class="wiki_link">repl-utils</a></li><li><a href="seq-utils-api.html" class="wiki_link">seq-utils</a></li><li><a href="server-socket-api.html" class="wiki_link">server-socket</a></li><li><a href="set-api.html" class="wiki_link">set</a></li><li><a href="shell-out-api.html" class="wiki_link">shell-out</a></li><li><a href="singleton-api.html" class="wiki_link">singleton</a></li><li><a href="sql-api.html" class="wiki_link">sql</a></li><li><a href="str-utils-api.html" class="wiki_link">str-utils</a></li><li><a href="str-utils2-api.html" class="wiki_link">str-utils2</a></li><li><a href="stream-utils-api.html" class="wiki_link">stream-utils</a></li><li><a href="swing-utils-api.html" class="wiki_link">swing-utils</a></li><li><a href="test-is-api.html" class="wiki_link">test-is</a></li><li><a href="trace-api.html" class="wiki_link">trace</a></li><li><a href="types-api.html" class="wiki_link">types</a></li><li><a href="with-ns-api.html" class="wiki_link">with-ns</a></li><li><a href="zip-filter-api.html" class="wiki_link">zip-filter</a></li>
</ul>
<div class="BranchTOC">
<span class="toc-header">Other Versions</span>
<ul id="left-sidebar-branch-list">
<li><a href="../index.html" class="wiki_link">v1.2 (stable)</a></li><li><a href="../branch-master/index.html" class="wiki_link">v1.3 (in development)</a></li>
</ul>
</div>
<a href="http://clojure.org" class="wiki_link">Clojure Home</a>
</div>
</div>
</div>
<div id="rightcolumn">
<div id="Content">
<div class="contentBox"><div class="innerContentBox">
<div id="content_view" class="wiki wikiPage">
<div id="right-sidebar"><div id="toc">
<h1 class="nopad">Table of Contents</h1>
<div style="margin-left: 1em;" class="toc-section">
<a href="#toc0">Overview</a>
<div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defalias">defalias</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defhinted">defhinted</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defmacro-">defmacro-</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defn-memo">defn-memo</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defnk">defnk</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defonce-">defonce-</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defstruct-">defstruct-</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defunbound">defunbound</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defunbound-">defunbound-</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defvar">defvar</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/defvar-">defvar-</a>
</div><div style="margin-left: 1em;" class="toc-entry">
<a href="#clojure.contrib.def/name-with-attributes">name-with-attributes</a>
</div>
<br />
</div>
</div>
</div>
<div id="content-tag"><h1 id="overview">API for <span id="namespace-name">def</span>
- <span id="header-project">clojure-contrib</span> <span id="header-version">v1.1</span> (<span id="header-status">stable</span>)
</h1>
<div class="error" id="main-deprecation-block">
<h3>clojure-contrib is now deprecated</h3>
<p>
clojure-contrib is no longer being developed or maintained.
</p>
<p>
Rather than a single, monolithic, contributions library, Clojure now has
a set of separate libraries for each unit of functionality. The libraries
are in the Clojure GitHub organization at
<a href="https://github.com/clojure">https://github.com/clojure</a>.
API documentation of the libraries can be found at
<a href="https://clojure.github.io">https://clojure.github.io</a>.
</p>
<p>
If you're looking for a specific function or namespace from the old
clojure-contrib, see
<a href="https://clojure.org/community/contrib_history">"Where Did Clojure.Contrib Go"</a>.
</p>
</div>
<br />Full namespace name: <span id="long-name">clojure.contrib.def</span>
<p></p>
<h2>Overview</h2>
<pre id="namespace-docstr"></pre>
<br />
<h2>Public Variables and Functions</h2>
<div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defalias">defalias</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defalias name orig)
(defalias name orig doc)
</pre>
<pre id="var-docstr">Defines an alias for a var: a new var with the same root binding (if
any) and similar metadata. The metadata of the alias is its initial
metadata (as provided by def) merged into the metadata of the original.</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L66" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defhinted">defhinted</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defhinted sym init)
</pre>
<pre id="var-docstr">Defines a var with a type hint matching the class of the given
init. Be careful about using any form of 'def' or 'binding' to a
value of a different type. See <a href="http://paste.lisp.org/display/73344">http://paste.lisp.org/display/73344</a></pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L83" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defmacro-">defmacro-</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defmacro- name & decls)
</pre>
<pre id="var-docstr">Same as defmacro but yields a private definition</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L39" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defn-memo">defn-memo</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defn-memo fn-name & defn-stuff)
</pre>
<pre id="var-docstr">Just like defn, but memoizes the function using clojure.core/memoize</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L141" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defnk">defnk</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defnk fn-name & fn-tail)
</pre>
<pre id="var-docstr">Define a function accepting keyword arguments. Symbols up to the first
keyword in the parameter list are taken as positional arguments. Then
an alternating sequence of keywords and defaults values is expected. The
values of the keyword arguments are available in the function body by
virtue of the symbol corresponding to the keyword (cf. :keys destructuring).
defnk accepts an optional docstring as well as an optional metadata map.</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L120" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defonce-">defonce-</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defonce- name expr)
(defonce- name expr doc)
</pre>
<pre id="var-docstr">Same as defonce but yields a private definition</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L59" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defstruct-">defstruct-</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defstruct- name & decls)
</pre>
<pre id="var-docstr">Same as defstruct but yields a private definition</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L54" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defunbound">defunbound</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defunbound name)
(defunbound name doc)
</pre>
<pre id="var-docstr">Defines an unbound var with optional doc string</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L32" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defunbound-">defunbound-</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defunbound- name & decls)
</pre>
<pre id="var-docstr">Same as defunbound but yields a private definition</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L49" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defvar">defvar</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defvar name)
(defvar name init)
(defvar name init doc)
</pre>
<pre id="var-docstr">Defines a var with an optional intializer and doc string</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L23" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/defvar-">defvar-</h2>
<span id="var-type">macro</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (defvar- name & decls)
</pre>
<pre id="var-docstr">Same as defvar but yields a private definition</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L44" id="var-source">Source</a>
</div><div id="var-entry">
<br />
<hr />
<h2 id="clojure.contrib.def/name-with-attributes">name-with-attributes</h2>
<span id="var-type">function</span><br />
<span class="deprecation-warning">This library, clojure-contrib, is deprecated. See <a href="#main-deprecation-block">here</a> for more information.</span><br />
<pre id="var-usage">Usage: (name-with-attributes name macro-args)
</pre>
<pre id="var-docstr">To be used in macro definitions.
Handles optional docstrings and attribute maps for a name to be defined
in a list of macro arguments. If the first macro argument is a string,
it is added as a docstring to name and removed from the macro argument
list. If afterwards the first macro argument is a map, its entries are
added to the name's metadata map and the map is removed from the
macro argument list. The return value is a vector containing the name
with its extended metadata map and the list of unprocessed macro
arguments.</pre>
<a href="https://github.com/clojure/clojure-contrib/blob/4df3fae61cbd538786a73908eb0b8fc176b3fefd/src/clojure/contrib/def.clj#L94" id="var-source">Source</a>
</div>
</div>
</div>
</div>
</div>
</div>
<div id="foot">
<div style="text-align: center;" id="copyright">Copyright 2007-2010 by Rich Hickey and the various contributors</div>
</div>
</div>
<div id="DesignedBy">Logo & site design by <a title="Visit Tom Hickey's website." href="http://www.tomhickey.com">Tom Hickey</a>.<br />
Clojure auto-documentation system by Tom Faulhaber.</div>
</div>
<!-- /AllContentContainer -->
</body>
</html>