PPI::Exception - The PPI exception base class

NAME  SYNOPSIS  DESCRIPTION  METHODS  new $message | message => $message, ...  throw  message  callers 

---

NAME

PPI::Exception − The PPI exception base class

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' );

DESCRIPTION

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

METHODS

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

Constructs and returns a new "PPI::Exception" object.

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

throw

If called on a "PPI::Exception" object, throws the object. If called on the class name, uses the arguments to construct a "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 "callers" method.

This method never returns.

message

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

callers

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

---