RE: Combining UTF-16 output with :crlf is awkward
[perl.git] / lib / exceptions.pl
1 # exceptions.pl
2 # tchrist@convex.com
3 #
4 # This library is no longer being maintained, and is included for backward
5 # compatibility with Perl 4 programs which may require it.
6 #
7 # In particular, this should not be used as an example of modern Perl
8 # programming techniques.
9 #
10
11 # Here's a little code I use for exception handling.  It's really just
12 # glorfied eval/die.  The way to use use it is when you might otherwise
13 # exit, use &throw to raise an exception.  The first enclosing &catch
14 # handler looks at the exception and decides whether it can catch this kind
15 # (catch takes a list of regexps to catch), and if so, it returns the one it
16 # caught.  If it *can't* catch it, then it will reraise the exception
17 # for someone else to possibly see, or to die otherwise.
18
19 # I use oddly named variables in order to make darn sure I don't conflict 
20 # with my caller.  I also hide in my own package, and eval the code in his.
21
22 # The EXCEPTION: prefix is so you can tell whether it's a user-raised
23 # exception or a perl-raised one (eval error).
24
25 # --tom
26 #
27 # examples:
28 #       if (&catch('/$user_input/', 'regexp', 'syntax error') {
29 #               warn "oops try again";
30 #               redo;
31 #       }
32 #
33 #       if ($error = &catch('&subroutine()')) { # catches anything
34 #
35 #       &throw('bad input') if /^$/;
36
37 sub catch {
38     package exception;
39     local($__code__, @__exceptions__) = @_;
40     local($__package__) = caller;
41     local($__exception__);
42
43     eval "package $__package__; $__code__";
44     if ($__exception__ = &'thrown) {
45         for (@__exceptions__) {
46             return $__exception__ if /$__exception__/;
47         } 
48         &'throw($__exception__);
49     } 
50
51
52 sub throw {
53     local($exception) = @_;
54     die "EXCEPTION: $exception\n";
55
56
57 sub thrown {
58     $@ =~ /^(EXCEPTION: )+(.+)/ && $2;
59
60
61 1;