Gecko [ www.vortexaion.com ]

Name	Size	Permission	Date
Document	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Exception	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Normal	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Statement	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Structure	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Token	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Transform	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Cache.pm	6.15 KB	-rw-rw-rw-	2019-07-09 19:15
Document.pm	21.86 KB	-rw-rw-rw-	2019-07-09 19:15
Dumper.pm	6.79 KB	-rw-rw-rw-	2019-07-09 19:15
Element.pm	22.23 KB	-rw-rw-rw-	2019-07-09 19:15
Exception.pm	1.95 KB	-rw-rw-rw-	2019-07-09 19:15
Find.pm	8.76 KB	-rw-rw-rw-	2019-07-09 19:15
Lexer.pm	40.64 KB	-rw-rw-rw-	2019-07-09 19:15
Node.pm	19.69 KB	-rw-rw-rw-	2019-07-09 19:15
Normal.pm	6.22 KB	-rw-rw-rw-	2019-07-09 19:15
Singletons.pm	3.1 KB	-rw-rw-rw-	2019-07-09 19:15
Statement.pm	8.83 KB	-rw-rw-rw-	2019-07-09 19:15
Structure.pm	8.61 KB	-rw-rw-rw-	2019-07-09 19:15
Token.pm	5.65 KB	-rw-rw-rw-	2019-07-09 19:15
Tokenizer.pm	33.05 KB	-rw-rw-rw-	2019-07-09 19:15
Transform.pm	5.81 KB	-rw-rw-rw-	2019-07-09 19:15
Util.pm	1.82 KB	-rw-rw-rw-	2019-07-09 19:15
XSAccessor.pm	2.34 KB	-rw-rw-rw-	2019-07-09 19:15

Rename

package PPI::Exception;

=head1 NAME

PPI::Exception - The PPI exception base class

=head1 SYNOPSIS

use PPI::Exception;
  
  my $e = PPI::Exception->new( 'something happened' );
  $e->throw;

PPI::Exception->new( message => 'something happened' )->throw;
  PPI::Exception->throw( message => 'something happened' );

=head1 DESCRIPTION

All exceptions thrown from within PPI will be instances or derivations
of this class.

=cut

use strict;
use Params::Util qw{_INSTANCE};

our $VERSION = '1.270'; # VERSION

=head1 METHODS

=head2 new $message | message => $message, ...

Constructs and returns a new C<PPI::Exception> object.

A message for the exception can be passed, either as a string
or as C<< message => $message >>. The message is available via the
C<message> method.

=cut

sub new {
	my $class = shift;
	return bless { @_ }, $class if @_ > 1;
	return bless { message => $_[0] }, $class if @_;
	return bless { message => 'Unknown Exception' }, $class;
}

=head2 throw

If called on a C<PPI::Exception> object, throws the object.
If called on the class name, uses the arguments to construct a
C<PPI::Exception> and then throw it.

Each time the object is thrown, information from the Perl <caller(0)>
call is saved and made available via the C<callers> method.

This method never returns.

=cut

sub throw {
	my $it = shift;
	if ( _INSTANCE($it, 'PPI::Exception') ) {
		if ( $it->{callers} ) {
			push @{ $it->{callers} }, [ caller(0) ];
		} else {
			$it->{callers} ||= [];
		}
	} else {
		my $message = $_[0] || 'Unknown Exception';
		$it = $it->new(
			message => $message,
			callers => [
				[ caller(0) ],
			],
		);
	}
	die $it;
}

=head2 message

Returns the exception message passed to the object's constructor,
or a default message.

=cut

sub message {
	$_[0]->{message};
}

=head2 callers

Returns a listref, each element of which is a listref of C<caller(0)>
information.  The returned listref can be empty.

=cut

sub callers {
	@{ $_[0]->{callers} || [] };
}