API for error-kit
- ()
by Chris Houser
clojure-contrib is now deprecated
clojure-contrib is no longer being developed or maintained.
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
https://github.com/clojure.
API documentation of the libraries can be found at
https://clojure.github.io.
If you're looking for a specific function or namespace from the old
clojure-contrib, see
"Where Did Clojure.Contrib Go".
Full namespace name:
clojure.contrib.error-kit
Overview
EXPERIMENTAL
System for defining and using custom errors
Please contact Chouser if you have any suggestions for better names
or API adjustments.
Public Variables and Functions
bind-continue
function
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (bind-continue continue-name [args*] & body)
Special form to be used inside a 'with-handler'.
Control can be passed to this 'continue' form from a 'raise' enclosed
in this with-handler's dynamic scope, when this 'continue-name' is
given to a 'continue' form.
Source
deferror
macro
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (deferror name [parent-error?] doc-string? [args*] & body)
(deferror name [parent-error?] doc-string? args-destruct-map & body)
Define a new error type
Source
do-not-handle
macro
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (do-not-handle)
Use in a tail position of a 'handle' form to indicate 'raise' should
not consider the error handled, but should continue searching for an
appropriate 'handle' form. Allows finer-grain control over catching
than just the error type.
Source
error
function
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (error details)
Base type for all error-kit errors
Source
handle
function
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (handle error-name? [args*] & body)
(handle error-name? args-destruct-map-args & body)
Special form to be used inside a 'with-handler'. When
any error is 'raised' from withing the dynamic scope of 'body' that
is of error-name's type or a derived type, the args will be bound
and the body executed. If no 'error-name' is given, the body will
be executed for regardless of the type of error raised. The body
may return a value, in which case that will be the return value of
the entire 'with-handler' form, or it may use any of the special
return forms, 'do-not-handle', 'continue-with', or 'continue'.
Source
raise
macro
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (raise err-name & args)
Raise an error of the type err-name, constructed with the given args
Source
raise*
function
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (raise* err)
Raise the given error object, best if created by an error
constructor defined with deferror. See also 'raise' macro.
Source
throw-msg
macro
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (throw-msg class-name)
Returns a function that throws a Java Exception with the given
name. Useful to associate a new error-kit error type with a
particular Java Exception class, via the :unhandled error key.
Source
with-handler
macro
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (with-handler & forms)
This is error-kit's dynamic scope form. The body will be executed
in a dynamic context that includes all of the following 'handle' and
'bind-continue' forms.
Source
