File Coverage

blib/lib/CPS/Future.pm

Criterion	Covered	Total	%
statement	12	12	100.0
branch			n/a
condition			n/a
subroutine	4	4	100.0
pod			n/a
total	16	16	100.0

#  You may distribute under the terms of either the GNU General Public License
#  or the Artistic License (the same terms as Perl itself)
#
#  (C) Paul Evans, 2012 -- [e-mail]

package CPS::Future;

use strict;
use warnings;

our $VERSION = '0.18';

use base qw( Future );

=head1 NAME

C - compatibility wrapper around L

=head1 DESCRIPTION

This module provides a compatibility wrapper around L. The code it
used to contain was renamed to move it out of the C distribution.
Existing code that refers to C should be changed to use C
instead.

=cut

=head2 $future->( @result )

This subclass overloads the calling operator, so simply invoking the future
object itself as if it were a C reference is equivalent to calling the
C method. This makes it simple to pass as a callback function to other
code.

It turns out however, that this behaviour is too subtle and can lead to bugs
when futures are accidentally used as plain C references. See the
C method instead. This overload behaviour will be removed in a later
version.

=cut

use overload '&{}' => 'done_cb',
             fallback => 1;

0x55AA;