my $coercion = $type->coercion_from_type('Int'); my $new_value = $coercion->coerce_value(42); if ( $coercion->can_be_inlined() ) { my $code = $coercion->inline_coercion('$_[0]'); }
Coercions can be implemented either as a simple subroutine reference or as an inline generator subroutine. Using an inline generator is faster but more complicated.
The type this coercion is from. The type must be an object which does the Specio::Constraint::Role::Interface interface.
This parameter is required.
The type this coercion is to. The type must be an object which does the Specio::Constraint::Role::Interface interface.
This parameter is required.
A subroutine reference implementing the coercion. It will be called as a method on the object and passed a single argument, the value to coerce.
It should return the new value.
This parameter is mutually exclusive with "inline_generator".
Either this parameter or the "inline_generator" parameter is required.
You can also pass this option with the key "using" in the parameter list.
This should be a subroutine reference which returns a string containing a single term. This code should not end in a semicolon. This code should implement the coercion.
The generator will be called as a method on the coercion with a single argument. That argument is the name of the variable being coerced, something like '$_[0]' or '$var'.
This parameter is mutually exclusive with "coercion".
Either this parameter or the "coercion" parameter is required.
You can also pass this option with the key "inline" in the parameter list.
This should be a hash reference of variable names (with sigils) and values for that variable. The values should be references to the values of the variables.
This environment will be used when compiling the coercion as part of a subroutine. The named variables will be captured as closures in the generated subroutine, using Eval::Closure.
It should be very rare to need to set this in the constructor. It's more likely that a special coercion subclass would need to provide values that it generates internally.
This parameter defaults to an empty hash reference.
This parameter must be a Specio::DeclaredAt object.
This parameter is required.
This method does not actually check that the types of given or return values.
Note that this method will die if the coercion does not have an inline generator.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
The full text of the license can be found in the LICENSE file included with this distribution.