Data::Object::Exception
Exception Class for Perl 5
use Data::Object::Exception; my $exception = Data::Object::Exception->new; # $exception->throw This package provides functionality for creating, throwing, and introspecting exception objects.
This package supports the following scenarios:
use Data::Object::Exception; my $exception = Data::Object::Exception->new('Oops!'); # $exception->throw The package allows objects to be instantiated with a single argument.
use Data::Object::Exception; my $exception = Data::Object::Exception->new(message => 'Oops!'); # $exception->throw The package allows objects to be instantiated with key-value arguments.
This package has the following attributes:
context(Any) This attribute is read-only, accepts (Any) values, and is optional.
id(Str) This attribute is read-only, accepts (Str) values, and is optional.
message(Str) This attribute is read-only, accepts (Str) values, and is optional.
This package implements the following methods:
explain() : Str The explain method returns an error message with stack trace.
-
explain example #1
use Data::Object::Exception; my $exception = Data::Object::Exception->new('Oops!'); $exception->explain
throw(Tuple[Str, Str] | Str $message, Any $context, Maybe[Number] $offset) : Any The throw method throws an error with message (and optionally, an ID).
-
throw example #1
use Data::Object::Exception; my $exception = Data::Object::Exception->new; $exception->throw('Oops!') -
throw example #2
use Data::Object::Exception; my $exception = Data::Object::Exception->new('Oops!'); $exception->throw -
throw example #3
use Data::Object::Exception; my $exception = Data::Object::Exception->new; $exception->throw(['E001', 'Oops!'])
trace(Int $offset, $Int $limit) : Object The trace method compiles a stack trace and returns the object. By default it skips the first frame.
-
trace example #1
use Data::Object::Exception; my $exception = Data::Object::Exception->new('Oops!'); $exception->trace(0) -
trace example #2
use Data::Object::Exception; my $exception = Data::Object::Exception->new('Oops!'); $exception->trace(1) -
trace example #3
use Data::Object::Exception; my $exception = Data::Object::Exception->new('Oops!'); $exception->trace(0,1)
Al Newkirk, awncorp@cpan.org
Copyright (C) 2011-2019, Al Newkirk, et al.
This is free software; you can redistribute it and/or modify it under the terms of the The Apache License, Version 2.0, as elucidated in the "license file".