Dave Rolsky > Specio-0.11 > Specio::Exception

Download:
Specio-0.11.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

Open  1
View/Report Bugs
Module Version: 0.11   Source  

NAME ^

Specio::Exception - A Throwable::Error subclass for type constraint failures

VERSION ^

version 0.11

DESCRIPTION ^

This exception class is thrown by Specio when a type check fails. It emulates the Throwable::Error API, but doesn't use that module to avoid adding a dependency on Moo.

DESCRIPTION ^

  use Try::Tiny;

  try {
      $type->validate_or_die($value);
  }
  catch {
      if ( $_->isa('Specio::Exception') ) {
          print $_->message(), "\n";
          print $_->type()->name(), "\n";
          print $_->value(), "\n";
      }
  };

API ^

This class provides the following methods:

$exception->message()

The error message associated with the exception.

$exception->stack_trace()

A Devel::StackTrace object for the exception.

$exception->type()

The type constraint object against which the value failed.

$exception->value()

The value that failed the type check.

$exception->as_string()

The exception as a string. This includes the method and the stack trace.

OVERLOADING ^

This class overloads stringification to call the as_string() method.

AUTHOR ^

Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE ^

This software is Copyright (c) 2014 by Dave Rolsky.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)
syntax highlighting: