NAME

Continuation::Escape - escape continuations (returning higher up the stack)

SYNOPSIS

use Continuation::Escape;

my $ret = call_cc {
    my $escape = shift;

    # ...
    sub {
        # ...
        $escape->(1 + 1);
        # code never reached
    }->();
    # code never reached
};

$ret # 2

NAME

An escape continuation is a limited type of continuation that only allows you to jump back up the stack. Invoking an escape continuation is a lot like throwing an exception, however escape continuations do not necessarily indicate exceptional circumstances.

This module builds on Vincent Pit's excellent Scope::Upper to give you a nicer interface to returning to outer scopes.

CONTEXT

If the return context of the continuation is scalar, the first argument to the continuation will be returned. This is slightly more useful than 1, the number of arguments to the continuation. This DWIMs when you want to return a scalar anyway.

CAVEATS

Escape continuations are not real continuations. They are not re-invokable (meaning you only get to run them once) and they are not savable (once the call_cc block ends, calling the continuation it gave you is an error). This module goes to some length to ensure that you do not try to do either of these things.

Real continuations in Perl would require a lot of work. But damn would they be nice. Does anyone know how much work would even be involved? :)

AUTHOR

Shawn M Moore, sartak@gmail.com

THANKS TO

Vincent Pit for writing the excellent Scope::Upper which does two things that I've wanted forever (escape continuations and localizing variables at higher stack levels).

COPYRIGHT AND LICENSE

Copyright 2009 Shawn M Moore.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.