/ 
Exception-Caught-0.01
River stage zero No dependents
/ Exception::Caught

NAME

Exception::Caught - Sugar for class-based exception handlers

VERSION

version 0.01

SYNOPSIS

use Try::Tiny;
use Exception::Caught;
use Exception::Class qw(MyException);

try {
    MyException->throw();
}
catch {
    rethrow unless caught('MyException');
    # do something special with $_
};

WHY?

Doing different things with an exception based on its class is a common pattern. TryCatch does a good job with this, but is a bit heavyweight. Try::Tiny is nice and lightweight, but doesn't help out with the type dispatching problem. Hence, this module. You don't have to use it with Try::Tiny, but that's what it's best at.

EXPORTS

Exception::Caught uses Sub::Exporter, so see that module if you want to rename these subroutines to something else. The subs are only exported for your lexical scope so that you don't get extra methods/subs in your package/class. If this isn't what you want, consider using Sub::Import.

caught and rethrow are exported by default.

caught(classname, exception?)

Returns true if the exception (optional argument, defaults to $_) passes isa() for the given classname.

rethrow(exception?)

Calls rethrow on the exception (optional argument, defaults to $_) if it is an object with a rethrow method, otherwise just dies with the exception.

AUTHOR

Paul Driver <frodwith@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Paul Driver <frodwith@cpan.org>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.