NAME

Egg::Exception - The exception with stack trace is generated.

SYNOPSIS

use Egg::Exception;

Egg::Error->throw('The error occurs.');

or

local $SIG{__DIE__}= sub { Egg::Error->throw(@_) };
die 'The error occurs.';

DESCRIPTION

It is a module to vomit the message with stack trace when the exception is generated.

METHODS

new

Constructor. This is internally called.

throw ([MESSAGE_STRING])

After the constructor is let pass, the exception is generated.

Egg::Error->throw( 'internal error.' );

stacktrace

Only trace information on the object is returned.

local $SIG{__DIE__}= sub { Egg::Error->throw(@_) };
eval{ ... code. };
if ($@) { die $@->stacktrace }

frames

Trace information on the object is returned by the ARRAY reference.

local $SIG{__DIE__}= sub { Egg::Error->throw(@_) };
eval{ ... code. };
if ($@) { die join "\n", @{$@->frames} }

as_string

as_string of "Devel::StackTrace " is returned.

local $SIG{__DIE__}= sub { Egg::Error->throw(@_) };
eval{ ... code. };
if ($@) { die $@->as_string }

errstr

Only the exception message of the object is returned.

local $SIG{__DIE__}= sub { Egg::Error->throw(@_) };
eval{ ... code. };
if ($@) { die $@->errstr }

SEE ALSO

Egg::Release, Devel::StackTrace,

AUTHOR

Masatoshi Mizuno, <lushe@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2008 Bee Flag, Corp. <http://egg.bomcity.com/>.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

cpanm Egg::Release

perl -MCPAN -e shell
install Egg::Release