NAME

Moose::Exception - Superclass for Moose internal exceptions

VERSION

version 2.2201

DESCRIPTION

This class contains attributes which are common to all Moose internal exception classes.

WARNING WARNING WARNING

If you're writing your own exception classes, you should instead prefer the Throwable role or the Throwable::Error superclass - this is effectively a cut-down internal fork of the latter, and not designed for use in user code.

Of course if you're writing metaclass traits, it would then make sense to subclass the relevant Moose exceptions - but only then.

METHODS

$exception->message

This attribute contains the exception message.

Every subclass of Moose::Exception is expected to override "_build_message" method in order to construct this value.

$exception->trace

This attribute contains the stack trace for the given exception. It returns a Devel::StackTrace object.

$exception->as_string

This method returns a stringified form of the exception, including a stack trace. By default, this method skips Moose-internal stack frames until it sees a caller outside of the Moose core. If the "MOOSE_FULL_EXCEPTION" environment variable is true, these frames are included.

AUTHORS

Stevan Little <stevan@cpan.org>
Dave Rolsky <autarch@urth.org>
Jesse Luehrs <doy@cpan.org>
Shawn M Moore <sartak@cpan.org>
יובל קוג'מן (Yuval Kogman) <nothingmuch@woobling.org>
Karen Etheridge <ether@cpan.org>
Florian Ragwitz <rafl@debian.org>
Hans Dieter Pearcey <hdp@cpan.org>
Chris Prather <chris@prather.org>
Matt S Trout <mstrout@cpan.org>

COPYRIGHT AND LICENSE

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