moosex::meta::typeconstraint::forcecoercion(3pm) [debian man page]

MooseX::Meta::TypeConstraint::ForceCoercion(3pm)	User Contributed Perl Documentation	  MooseX::Meta::TypeConstraint::ForceCoercion(3pm)

NAME

       MooseX::Meta::TypeConstraint::ForceCoercion - Force coercion when validating type constraints

VERSION

       version 0.01

SYNOPSIS

	   use MooseX::Types:::Moose qw/Str Any/;
	   use Moose::Util::TypeConstraints;
	   use MooseX::Meta::TypeConstraint::ForceCoercion;

	   # get any type constraint
	   my $tc = Str;

	   # declare one or more coercions for it
	   coerce $tc,
	       from Any,
	       via { ... };

	   # wrap the $tc to force coercion
	   my $coercing_tc = MooseX::Meta::TypeConstraint::ForceCoercion->new(
	       type_constraint => $tc,
	   );

	   # check a value against new type constraint. this will run the type
	   # coercions for the wrapped type, even if the value already passes
	   # validation before coercion. it will fail if the value couldn't be
	   # coerced
	   $coercing_tc->check('Affe');

DESCRIPTION

       This class allows to wrap any "Moose::Meta::TypeConstraint" in a way that will force coercion of the value when checking or validating a
       value against it.

ATTRIBUTES

   type_constraint
       The type constraint to wrap. All methods except for "validate" and "check" are delegated to the value of this attribute.

METHODS

   check ($value)
       Same as "Moose::Meta::TypeConstraint::check", except it will always try to coerce $value before checking it against the actual type
       constraint. If coercing fails the check will fail, too.

   validate ($value, $coerced_ref?)
       Same as "Moose::Meta::TypeConstraint::validate", except it will always try to coerce $value before validating it against the actual type
       constraint. If coercing fails the validation will fail, too.

       If coercion was successful and a $coerced_ref references was passed, the coerced value will be stored in that.

AUTHOR

	 Florian Ragwitz <rafl@debian.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2009 by Florian Ragwitz.

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

perl v5.10.0							    2009-04-13			  MooseX::Meta::TypeConstraint::ForceCoercion(3pm)

Moose::Meta::TypeCoercion(3)				User Contributed Perl Documentation			      Moose::Meta::TypeCoercion(3)

NAME

       Moose::Meta::TypeCoercion - The Moose Type Coercion metaclass

VERSION

       version 2.0604

DESCRIPTION

       A type coercion object is basically a mapping of one or more type constraints and the associated coercions subroutines.

       It's unlikely that you will need to instantiate an object of this class directly, as it's part of the deep internals of Moose.

METHODS

       Moose::Meta::TypeCoercion->new(%options)
	   Creates a new type coercion object, based on the options provided.

	   o	   type_constraint

		   This is the Moose::Meta::TypeConstraint object for the type that is being coerced to.

       $coercion->type_coercion_map
	   This returns the map of type constraints to coercions as an array reference. The values of the array alternate between type names and
	   subroutine references which implement the coercion.

	   The value is an array reference because coercions are tried in the order they are added.

       $coercion->type_constraint
	   This returns the Moose::Meta::TypeConstraint that was passed to the constructor.

       $coercion->has_coercion_for_type($type_name)
	   Returns true if the coercion can coerce the named type.

       $coercion->add_type_coercions( $type_name => $sub, ... )
	   This method takes a list of type names and subroutine references. If the coercion already has a mapping for a given type, it throws an
	   exception.

	   Coercions are actually

       $coercion->coerce($value)
	   This method takes a value and applies the first valid coercion it finds.

	   This means that if the value could belong to more than type in the coercion object, the first coercion added is used.

       Moose::Meta::TypeCoercion->meta
	   This will return a Class::MOP::Class instance for this class.

BUGS

       See "BUGS" in Moose for details on reporting bugs.

AUTHOR

       Moose is maintained by the Moose Cabal, along with the help of many contributors. See "CABAL" in Moose and "CONTRIBUTORS" in Moose for
       details.

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Infinity Interactive, Inc..

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.16.2							    2012-09-19					      Moose::Meta::TypeCoercion(3)