package Lexical::Types;
-use 5.008003;
+use 5.008_003;
use strict;
use warnings;
XSLoader::load(__PACKAGE__, $VERSION);
}
-=head1 FUNCTIONS
+=head1 METHODS
-=head2 C<< import [ as => [ $prefix | $mangler ] ] >>
+=head2 C<import>
-Magically called when writing C<use Lexical::Types>.
+ use Lexical::Types;
+ use Lexical::Types as => $prefix;
+ use Lexical::Types as => sub { ... }; # = $mangler
+
+Magically called when C<use Lexical::Types> is encountered.
All the occurences of C<my Str $x> in the current lexical scope will be changed to call at each run a given method in a given package.
The method and package are determined by the parameter C<'as'> :
either an empty list, in which case the current typed lexical definition will be skipped (thus it won't be altered to trigger a run-time hook) ;
- use Lexical::Types as => sub { return $_[0] =~ /Str/ ? @_ : () };
+ use Lexical::Types as => sub {
+ return $_[0] =~ /Str/ ? @_ : ()
+ };
my Str $y; # calls Str->TYPEDSCALAR
my Int $x; # nothing special
=head2 C<unimport>
-Magically called when writing C<no Lexical::Types>.
+ no Lexical::Types;
+
+Magically called when C<no Lexical::Types> is encountered.
Turns the pragma off.
=cut
Only one mangler or prefix can be in use at the same time in a given scope.
+Typed lexicals declarations that appear in code C<eval>'d during the global destruction phase of a spawned thread or pseudo-fork (the processes used internally for the C<fork> emulation on Windows) are ignored.
+
The implementation was tweaked to work around several limitations of vanilla C<perl> pragmas : it's thread safe, and doesn't suffer from a C<perl 5.8.x-5.10.0> bug that causes all pragmas to propagate into C<require>d scopes.
With 5.8 perls, the pragma does not propagate into C<eval STRING>.
A C compiler.
This module may happen to build with a C++ compiler as well, but don't rely on it, as no guarantee is made in this regard.
-L<XSLoader> (standard since perl 5.006).
+L<XSLoader> (standard since perl 5.6.0).
=head1 SEE ALSO