X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=lib%2FLexical%2FTypes.pm;h=642d2ce1d6937fa3c54c917f08e7e79f62c64551;hb=1a019acca86cfa85a067bd85249fa5981f6e13a8;hp=a8be1c4bb72b1582ce61f005879896803a5493fb;hpb=2217d97ba313979a7103df908a936b36a8c3f457;p=perl%2Fmodules%2FLexical-Types.git diff --git a/lib/Lexical/Types.pm b/lib/Lexical/Types.pm index a8be1c4..642d2ce 100644 --- a/lib/Lexical/Types.pm +++ b/lib/Lexical/Types.pm @@ -1,25 +1,23 @@ package Lexical::Types; -use 5.008001; +use 5.008003; use strict; use warnings; -use Carp qw/croak/; - =head1 NAME Lexical::Types - Extend the semantics of typed lexicals. =head1 VERSION -Version 0.09 +Version 0.12 =cut our $VERSION; BEGIN { - $VERSION = '0.09'; + $VERSION = '0.12'; } =head1 SYNOPSIS @@ -78,11 +76,15 @@ BEGIN { XSLoader::load(__PACKAGE__, $VERSION); } -=head1 FUNCTIONS +=head1 METHODS + +=head2 C -=head2 C<< import [ as => [ $prefix | $mangler ] ] >> + use Lexical::Types; + use Lexical::Types as => $prefix; + use Lexical::Types as => sub { ... }; # = $mangler -Magically called when writing C. +Magically called when C is encountered. All the occurences of C 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'> : @@ -152,7 +154,8 @@ sub import { $as .= '::' if $as !~ /::$/; $hint = _tag(sub { $as . $_[0] }); } else { - croak "Invalid $r reference for 'as'"; + require Carp; + Carp::croak("Invalid $r reference for 'as'"); } } else { $hint = _tag(sub { @_ }); @@ -166,7 +169,9 @@ sub import { =head2 C -Magically called when writing C. + no Lexical::Types; + +Magically called when C is encountered. Turns the pragma off. =cut @@ -222,7 +227,7 @@ If you prefer to use constants rather than creating empty packages, you can repl sub import { my $pkg = caller; - for (qw/Str Int/) { + for (qw) { my $type = __PACKAGE__ . '::' . $_; no strict 'refs'; no warnings 'redefine'; @@ -251,6 +256,11 @@ If you prefer to use constants rather than creating empty packages, you can repl True iff the module could have been built with thread-safety features enabled. +=head2 C + +True iff this module could have been built with fork-safety features enabled. +This will always be true except on Windows where it's false for perl 5.10.0 and below . + =head1 CAVEATS The restrictions on the type (being either a defined package name or a constant) apply even if you use the C<'as'> option to redirect to another package, and are unlikely to find a workaround as this happens deep inside the lexer - far from the reach of an extension. @@ -264,7 +274,7 @@ This is due to a shortcoming in the way perl handles the hints hash, which is ad =head1 DEPENDENCIES -L 5.8.1. +L 5.8.3. 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. @@ -285,7 +295,8 @@ You can contact me by mail or on C (vincent). =head1 BUGS -Please report any bugs or feature requests to C, or through the web interface at L. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. +Please report any bugs or feature requests to C, or through the web interface at L. +I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. =head1 SUPPORT