NAME

POE::Request::Return - encapsulates final replies to POE::Request messages

SYNOPSIS

        # Note, this is not a complete program.
        # See the distribution's examples directory.

        my $req;
        $req->return(
                type        => "failure",
                args        => {
                        function  => "connect",
                        errnum    => $!+0,
                        errstr    => "$!",
                },
        );

DESCRIPTION

POE::Request::Return objects are used internally to encapsulate messages sent by $some_request->return(...). Returned messages end their transactions.

BUGS

See http://thirdlobe.com/projects/poe-stage/report/1 for known issues. See http://thirdlobe.com/projects/poe-stage/newticket to report one.

POE::Stage is too young for production use. For example, its syntax is still changing. You probably know what you don't like, or what you need that isn't included, so consider fixing or adding that, or at least discussing it with the people on POE's mailing list or IRC channel. Your feedback and contributions will bring POE::Stage closer to usability. We appreciate it.

SEE ALSO

POE::Request::Return is comprised almost entirely of POE::Request::Upward's features. You should see POE::Request::Upward for a deeper understanding of POE::Request::Return, and POE::Request for a more in-depth discussion of POE requests in general.

AUTHORS

Rocco Caputo <rcaputo@cpan.org>.

LICENSE

POE::Request::Return is Copyright 2005-2006 by Rocco Caputo. All rights are reserved. You may use, modify, and/or distribute this module under the same terms as Perl itself.