NAME

    POE::Future - use Future with POE

SYNOPSIS

       use POE::Future;
    
       my $future = POE::Future->new_delay( 10 )
          ->then_done( "Hello, world!" );
    
       say $future->get;

DESCRIPTION

    This subclass of Future integrates with POE, allowing the await method
    to block until the future is ready. It allows POE-using code to be
    written that returns Future instances, so that it can make full use of
    Future's abilities, including Future::Utils, and also that modules
    using it can provide a Future-based asynchronous interface of their
    own.

    For a full description on how to use Futures, see the Future
    documentation.

CONSTRUCTORS

 new

       $f = POE::Future->new;

    Returns a new leaf future instance, which will allow waiting for its
    result to be made available, using the await method.

 new_delay

       $f = POE::Future->new_delay( $after );

    Returns a new leaf future instance which will become ready (with an
    empty result) after the specified delay time.

 new_alarm

       $f = POE::Future->new_alarm( $at );

    Returns a new leaf future instance which will become ready (with an
    empty result) at the specified alarm time.

    To create a delay or alarm timer that will fail instead of succeed, use
    the then_fail method:

       my $f = POE::Future->new_delay( 20 )
          ->then_fail( "Timeout" );

AUTHOR

    Paul Evans <leonerd@leonerd.org.uk>

