CatalystX::Usul::Exception - Exception base class

0.3.$Revision: 596 $

   use base qw(CatalystX::Usul);

   sub some_method {
      my $self = shift; my $e;

      eval { this_will_fail }

      $self->throw( $e ) if ($e = $self->catch);
   }

Implements try (by way of an eval), throw, and catch error semantics. Inherits from Exception::Class

Catches and returns a thrown exception or generates a new exception if EVAL_ERROR has been set

   warn $e->as_string( $verbosity, $offset );

Serialise the exception to a string. The passed parameters; verbosity and offset determine how much output is returned.

The verbosity parameter can be:

1

The default value. Only show a stack trace if $self->show_trace is true

2

Always show the stack trace and start at frame offset which defaults to 1. The stack trace stops when the first duplicate output line is detected

3

Always shows the complete stack trace starting at frame 0

Create (or re-throw) an exception to be caught by the catch above. If the passed parameter is a reference it is re-thrown. If a single scalar is passed it is taken to be an error message code, a new exception is created with all other parameters taking their default values. If more than one parameter is passed the it is treated as a list and used to instantiate the new exception. The 'error' parameter must be provided in this case

None

The $IGNORE package variable is list of methods whose presence should be suppressed in the stack trace output

Exception::Class

List::Util

There are no known incompatibilities in this module

The default ignore package list should be configurable

There are no known bugs in this module. Please report problems to the address below. Patches are welcome

Peter Flanigan <Support at RoxSoft.co.uk>

Copyright (c) 2008 Peter Flanigan. All rights reserved

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic

This program is distributed in the hope that it will be useful, but WITHOUT WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE