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