Exception.st
author Claus Gittinger <cg@exept.de>
Tue, 09 Jul 2019 20:55:17 +0200
changeset 24417 03b083548da2
parent 21036 2b57613c94b7
child 21042 edb2e7f82c62
permissions -rw-r--r--
#REFACTORING by exept class: Smalltalk class changed: #recursiveInstallAutoloadedClassesFrom:rememberIn:maxLevels:noAutoload:packageTop:showSplashInLevels: Transcript showCR:(... bindWith:...) -> Transcript showCR:... with:...
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
     1
"
a27a279701f8 Initial revision
claus
parents:
diff changeset
     2
 COPYRIGHT (c) 1993 by Claus Gittinger
171
129f0e2e23df handling now in Exception
claus
parents: 142
diff changeset
     3
	      All Rights Reserved
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
     4
a27a279701f8 Initial revision
claus
parents:
diff changeset
     5
 This software is furnished under a license and may be used
a27a279701f8 Initial revision
claus
parents:
diff changeset
     6
 only in accordance with the terms of that license and with the
a27a279701f8 Initial revision
claus
parents:
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
a27a279701f8 Initial revision
claus
parents:
diff changeset
     8
 be provided or otherwise made available to, or used by, any
a27a279701f8 Initial revision
claus
parents:
diff changeset
     9
 other person.  No title to or ownership of the software is
a27a279701f8 Initial revision
claus
parents:
diff changeset
    10
 hereby transferred.
a27a279701f8 Initial revision
claus
parents:
diff changeset
    11
"
20093
169c6926169a #OTHER by mawalch
mawalch
parents: 7630
diff changeset
    12
"{ Package: 'stx:libbasic' }"
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    13
20093
169c6926169a #OTHER by mawalch
mawalch
parents: 7630
diff changeset
    14
"{ NameSpace: Smalltalk }"
6206
59d1ec1e1ed5 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 4501
diff changeset
    15
4481
f3f7e1af7489 added GenericException in-between, to allow for some exceptions
Claus Gittinger <cg@exept.de>
parents: 4480
diff changeset
    16
GenericException subclass:#Exception
f3f7e1af7489 added GenericException in-between, to allow for some exceptions
Claus Gittinger <cg@exept.de>
parents: 4480
diff changeset
    17
	instanceVariableNames:''
f3f7e1af7489 added GenericException in-between, to allow for some exceptions
Claus Gittinger <cg@exept.de>
parents: 4480
diff changeset
    18
	classVariableNames:''
1118
1037616d9add ignore unhandled querySignals
Claus Gittinger <cg@exept.de>
parents: 1038
diff changeset
    19
	poolDictionaries:''
1037616d9add ignore unhandled querySignals
Claus Gittinger <cg@exept.de>
parents: 1038
diff changeset
    20
	category:'Kernel-Exceptions'
1
a27a279701f8 Initial revision
claus
parents:
diff changeset
    21
!
a27a279701f8 Initial revision
claus
parents:
diff changeset
    22
1953
c8a3af54acb3 unhandled querySignals should return nil
Claus Gittinger <cg@exept.de>
parents: 1710
diff changeset
    23
!Exception class methodsFor:'documentation'!
12
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    24
88
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    25
copyright
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    26
"
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    27
 COPYRIGHT (c) 1993 by Claus Gittinger
171
129f0e2e23df handling now in Exception
claus
parents: 142
diff changeset
    28
	      All Rights Reserved
88
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    29
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    30
 This software is furnished under a license and may be used
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    31
 only in accordance with the terms of that license and with the
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    32
 inclusion of the above copyright notice.   This software may not
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    33
 be provided or otherwise made available to, or used by, any
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    34
 other person.  No title to or ownership of the software is
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    35
 hereby transferred.
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    36
"
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    37
!
81dacba7a63a *** empty log message ***
claus
parents: 77
diff changeset
    38
12
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    39
documentation
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    40
"
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    41
    Exception is an abstract superclass of all exceptions in the system,
7630
fced37c5cccc Undo previous change form cg (on his request!).
Stefan Vogel <sv@exept.de>
parents: 7038
diff changeset
    42
    which are not generated by user actions (e.g. keyboard interrupts) nor by
fced37c5cccc Undo previous change form cg (on his request!).
Stefan Vogel <sv@exept.de>
parents: 7038
diff changeset
    43
    errors in the exception system itself.
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    44
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    45
    Think twice before subclassing directly from Exception. Consider to subclass
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    46
    from one of Exceptions subclasses Error, Warning, UserNotification...
7630
fced37c5cccc Undo previous change form cg (on his request!).
Stefan Vogel <sv@exept.de>
parents: 7038
diff changeset
    47
fced37c5cccc Undo previous change form cg (on his request!).
Stefan Vogel <sv@exept.de>
parents: 7038
diff changeset
    48
    You should also handle Error instead of Exception, since breakpoints,
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    49
    halts and user informational messages are processed as exceptions.
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    50
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    51
    The behavior is in GenericException, to allow for some exceptions 
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    52
    (UnhandledExceptionException and UserInterrupts) not to be a child of Exception.
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    53
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    54
    [see also:]
7038
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    55
        Error
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    56
        Warning
89e892bb8226 Documentation
Stefan Vogel <sv@exept.de>
parents: 6206
diff changeset
    57
        UserNotification
20093
169c6926169a #OTHER by mawalch
mawalch
parents: 7630
diff changeset
    58
        Notification
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    59
        Signal
2174
3c6300f27f74 example section;
Claus Gittinger <cg@exept.de>
parents: 2081
diff changeset
    60
"
12
8e03bd717355 *** empty log message ***
claus
parents: 3
diff changeset
    61
! !
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    62
21036
2b57613c94b7 #DOCUMENTATION by stefan
Stefan Vogel <sv@exept.de>
parents: 20093
diff changeset
    63
!Exception class methodsFor:'testing'!
2b57613c94b7 #DOCUMENTATION by stefan
Stefan Vogel <sv@exept.de>
parents: 20093
diff changeset
    64
2b57613c94b7 #DOCUMENTATION by stefan
Stefan Vogel <sv@exept.de>
parents: 20093
diff changeset
    65
isAbstract
2b57613c94b7 #DOCUMENTATION by stefan
Stefan Vogel <sv@exept.de>
parents: 20093
diff changeset
    66
    ^ self == Exception
2b57613c94b7 #DOCUMENTATION by stefan
Stefan Vogel <sv@exept.de>
parents: 20093
diff changeset
    67
! !
2b57613c94b7 #DOCUMENTATION by stefan
Stefan Vogel <sv@exept.de>
parents: 20093
diff changeset
    68
20093
169c6926169a #OTHER by mawalch
mawalch
parents: 7630
diff changeset
    69
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    70
!Exception class methodsFor:'documentation'!
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    71
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    72
version
20093
169c6926169a #OTHER by mawalch
mawalch
parents: 7630
diff changeset
    73
    ^ '$Header$'
4482
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    74
076e242d8fdd *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 4481
diff changeset
    75
! !
20093
169c6926169a #OTHER by mawalch
mawalch
parents: 7630
diff changeset
    76