Data::Object::Exception

Exception Class for Perl 5

method: explain method: throw method: trace

id: ro, opt, Str context: ro, opt, Any message: ro, opt, Str

use Data::Object::Exception;

my $exception = Data::Object::Exception->new;

# $exception->throw

This package provides functionality for creating, throwing, and introspecting exception objects.

The package allows objects to be instantiated with a single argument.

use Data::Object::Exception;

my $exception = Data::Object::Exception->new('Oops!');

# $exception->throw

The package allows objects to be instantiated with key-value arguments.

use Data::Object::Exception;

my $exception = Data::Object::Exception->new(message => 'Oops!');

# $exception->throw

The throw method throws an error with message (and optionally, an ID).

throw(Tuple[Str, Str] | Str $message, Any $context, Maybe[Number] $offset) : Any

=example-1 throw

use Data::Object::Exception;

my $exception = Data::Object::Exception->new;

$exception->throw('Oops!')

=example-2 throw

use Data::Object::Exception;

my $exception = Data::Object::Exception->new('Oops!');

$exception->throw

=example-3 throw

use Data::Object::Exception;

my $exception = Data::Object::Exception->new;

$exception->throw(['E001', 'Oops!'])

The explain method returns an error message with stack trace.

explain() : Str

=example-1 explain

use Data::Object::Exception;

my $exception = Data::Object::Exception->new('Oops!');

$exception->explain

The trace method compiles a stack trace and returns the object. By default it skips the first frame.

trace(Int $offset, $Int $limit) : Object

=example-1 trace

use Data::Object::Exception;

my $exception = Data::Object::Exception->new('Oops!');

$exception->trace(0)

=example-2 trace

use Data::Object::Exception;

my $exception = Data::Object::Exception->new('Oops!');

$exception->trace(1)

=example-3 trace

use Data::Object::Exception;

my $exception = Data::Object::Exception->new('Oops!');

$exception->trace(0,1)

cpanm Data::Object::Exception

perl -MCPAN -e shell
install Data::Object::Exception