View on
MetaCPAN
Christian Walde > PPI-1.224 > PPI::Exception

Download:
PPI-1.224.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 1.224   Source   Latest Release: PPI-1.237_001

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.

syntax highlighting: