Debian Codegraph @

info/gcl/condition.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html>
3 <!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
4 <head>
5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
6 <title>condition (ANSI and GNU Common Lisp Document)</title>
7
8 <meta name="description" content="condition (ANSI and GNU Common Lisp Document)">
9 <meta name="keywords" content="condition (ANSI and GNU Common Lisp Document)">
10 <meta name="resource-type" content="document">
11 <meta name="distribution" content="global">
12 <meta name="Generator" content="makeinfo">
13 <link href="index.html" rel="start" title="Top">
14 <link href="Conditions-Dictionary.html" rel="up" title="Conditions Dictionary">
15 <link href="warning.html" rel="next" title="warning">
16 <link href="Conditions-Dictionary.html" rel="prev" title="Conditions Dictionary">
17 <style type="text/css">
18 <!--
19 a.summary-letter {text-decoration: none}
20 blockquote.indentedblock {margin-right: 0em}
21 div.display {margin-left: 3.2em}
22 div.example {margin-left: 3.2em}
23 div.lisp {margin-left: 3.2em}
24 kbd {font-style: oblique}
25 pre.display {font-family: inherit}
26 pre.format {font-family: inherit}
27 pre.menu-comment {font-family: serif}
28 pre.menu-preformatted {font-family: serif}
29 span.nolinebreak {white-space: nowrap}
30 span.roman {font-family: initial; font-weight: normal}
31 span.sansserif {font-family: sans-serif; font-weight: normal}
32 ul.no-bullet {list-style: none}
33 -->
34 </style>
35
36
37 </head>
38
39 <body lang="en">
40 <span id="condition"></span><div class="header">
41 <p>
42 Next: <a href="warning.html" accesskey="n" rel="next">warning</a>, Previous: <a href="Conditions-Dictionary.html" accesskey="p" rel="prev">Conditions Dictionary</a>, Up: <a href="Conditions-Dictionary.html" accesskey="u" rel="up">Conditions Dictionary</a> &nbsp; </p>
43 </div>
44 <hr>
45 <span id="condition-_005bCondition-Type_005d"></span><h4 class="subsection">9.2.1 condition [Condition Type]</h4>
46
47 <p>[Reviewer Note by Barrett: I think CONDITION-RESTARTS is not fully integrated.]
48 </p>
49 <span id="Class-Precedence-List_003a_003a-19"></span><h4 class="subsubheading">Class Precedence List::</h4>
50 <p><b>condition</b>,
51 <b>t</b>
52 </p>
53 <span id="Description_003a_003a-171"></span><h4 class="subsubheading">Description::</h4>
54
55 <p>All types of <i>conditions</i>, whether error or
56 non-error, must inherit from this <i>type</i>.
57 </p>
58 <p>No additional <i>subtype</i> relationships among the specified <i>subtypes</i> of <i>type</i> <b>condition</b>
59 are allowed, except when explicitly mentioned in the text; however
60 implementations are permitted to introduce additional <i>types</i>
61 and one of these <i>types</i> can be a <i>subtype</i> of any
62 number of the <i>subtypes</i> of <i>type</i> <b>condition</b>.
63 </p>
64 <p>Whether a user-defined <i>condition</i> <i>type</i> has <i>slots</i>
65 that are accessible by <i>with-slots</i> is <i>implementation-dependent</i>.
66 Furthermore, even in an <i>implementation</i>
67 in which user-defined <i>condition</i> <i>types</i> would have <i>slots</i>,
68 it is <i>implementation-dependent</i> whether any <i>condition</i>
69 <i>types</i> defined in this document have such <i>slots</i> or,
70 if they do, what their <i>names</i> might be;
71 only the reader functions documented by this specification may be relied
72 upon by portable code.
73 </p>
74 <p><i>Conforming code</i> must observe the following restrictions related to
75 <i>conditions</i>:
76 </p>
77 <dl compact="compact">
78 <dt><tt>*</tt></dt>
79 <dd><p><b>define-condition</b>, not <b>defclass</b>, must be used
80 to define new <i>condition</i> <i>types</i>.
81 </p>
82 </dd>
83 <dt><tt>*</tt></dt>
84 <dd><p><b>make-condition</b>, not <b>make-instance</b>, must be used to
85 create <i>condition</i> <i>objects</i> explicitly.
86 </p>
87 </dd>
88 <dt><tt>*</tt></dt>
89 <dd><p>The <tt>:report</tt> option of <b>define-condition</b>, not <b>defmethod</b>
90 for <b>print-object</b>, must be used to define a condition reporter.
91 </p>
92 </dd>
93 <dt><tt>*</tt></dt>
94 <dd><p><b>slot-value</b>, <b>slot-boundp</b>, <b>slot-makunbound</b>,
95 and <b>with-slots</b> must not be used on <i>condition</i> <i>objects</i>.
96 Instead, the appropriate accessor functions (defined by <b>define-condition</b>)
97 should be used.
98 </p></dd>
99 </dl>
100
101
102
103
104 </body>
105 </html>