Commit | Line | Data |
---|---|---|
0109c4bf MD |
1 | ;;; installed-scm-file |
2 | ||
3 | ;;;; Copyright (C) 2001 Free Software Foundation, Inc. | |
4 | ;;;; | |
5 | ;;;; This program is free software; you can redistribute it and/or modify | |
6 | ;;;; it under the terms of the GNU General Public License as published by | |
7 | ;;;; the Free Software Foundation; either version 2, or (at your option) | |
8 | ;;;; any later version. | |
9 | ;;;; | |
10 | ;;;; This program is distributed in the hope that it will be useful, | |
11 | ;;;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | ;;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
13 | ;;;; GNU General Public License for more details. | |
14 | ;;;; | |
15 | ;;;; You should have received a copy of the GNU General Public License | |
16 | ;;;; along with this software; see the file COPYING. If not, write to | |
17 | ;;;; the Free Software Foundation, Inc., 59 Temple Place, Suite 330, | |
18 | ;;;; Boston, MA 02111-1307 USA | |
a482f2cc MV |
19 | ;;;; |
20 | ;;;; As a special exception, the Free Software Foundation gives permission | |
21 | ;;;; for additional uses of the text contained in its release of GUILE. | |
22 | ;;;; | |
23 | ;;;; The exception is that, if you link the GUILE library with other files | |
24 | ;;;; to produce an executable, this does not by itself cause the | |
25 | ;;;; resulting executable to be covered by the GNU General Public License. | |
26 | ;;;; Your use of that executable is in no way restricted on account of | |
27 | ;;;; linking the GUILE library code into it. | |
28 | ;;;; | |
29 | ;;;; This exception does not however invalidate any other reasons why | |
30 | ;;;; the executable file might be covered by the GNU General Public License. | |
31 | ;;;; | |
32 | ;;;; This exception applies only to the code released by the | |
33 | ;;;; Free Software Foundation under the name GUILE. If you copy | |
34 | ;;;; code from other Free Software Foundation releases into a copy of | |
35 | ;;;; GUILE, as the General Public License permits, the exception does | |
36 | ;;;; not apply to the code that you add in this way. To avoid misleading | |
37 | ;;;; anyone as to the status of such modified files, you must delete | |
38 | ;;;; this exception notice from them. | |
39 | ;;;; | |
40 | ;;;; If you write modifications of your own for GUILE, it is your choice | |
41 | ;;;; whether to permit this exception to apply to your modifications. | |
42 | ;;;; If you do not wish that, delete this exception notice. | |
0109c4bf MD |
43 | ;;;; |
44 | ||
45 | (define-module (ice-9 stack-catch) | |
46 | :export (stack-catch)) | |
47 | ||
48 | (define (stack-catch key thunk handler) | |
49 | "Like @code{catch}, invoke @var{thunk} in the dynamic context of | |
50 | @var{handler} for exceptions matching @var{key}, but also save the | |
51 | current stack state in the @var{the-last-stack} fluid, for the purpose | |
52 | of debugging or re-throwing of an error. If thunk throws to the | |
53 | symbol @var{key}, then @var{handler} is invoked this way:\n | |
54 | @example | |
55 | (handler key args ...) | |
56 | @end example\n | |
57 | @var{key} is a symbol or #t.\n | |
58 | @var{thunk} takes no arguments. If @var{thunk} returns normally, that | |
59 | is the return value of @code{catch}.\n | |
60 | Handler is invoked outside the scope of its own @code{catch}. If | |
61 | @var{handler} again throws to the same key, a new handler from further | |
62 | up the call chain is invoked.\n | |
63 | If the key is @code{#t}, then a throw to @emph{any} symbol will match | |
64 | this call to @code{catch}." | |
65 | (catch key | |
66 | (lambda () | |
67 | (lazy-catch key | |
68 | thunk | |
69 | lazy-handler-dispatch)) | |
70 | handler)) |