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