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/>, All Rights Reserved.

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.