NAME

Compile::Generators - Python-like generator subroutines for Perl

SYNOPSIS

    use Compile::Generators;

    sub gen_range :generator {
        my ($min, $max) = @_;
        my $num = $min;
        my $incr;

        while (not defined $max or $num < $max) {
            $incr = shift || 1;
            yield $num;
            $num += $incr;
        }
    }

    my $range = gen_range(50, 100);
    my $i = gen_range(1);

    while (my $num = $range->($i->())) {
        print "\$num => $num\n";
    }

When run, this prints:

    $num => 50
    $num => 51
    $num => 53
    $num => 56
    $num => 60
    $num => 65
    $num => 71
    $num => 78
    $num => 86
    $num => 95

DESCRIPTION

Compile::Generators lets you define subroutines that return their code as a generator. You can then call the generator over and over until it returns an empty list. The generator can yield (return) a value and then when you call it again it resumes right after the yield.

USAGE

Any subroutine marked with the a :generator attribute will have its code wrapped into a closure and returned by the subroutine. Any yield statements will be replace with code to return/resume at that point.

Any code before the first blank line in the sub will not be a part of the closure but will be executed when the sub is actually called. This means that any variables that are defined before the blank line will be closed by the generator sub.

This module uses Module::Compile to compile the generators. Look inside the .pmc to see what is really happening.

Since this module uses goto statements, you cannot yield inside a for loop. Perl does not allow this. However you can use while statements.

Currently a yield statement needs to be a simple statement on it's own line, since this gets parsed and replaced by a return/goto-label.

See the tests for examples.

AUTHOR

Ingy döt Net <ingy@cpan.org>

COPYRIGHT

Copyright (c) 2006. Ingy döt Net. All rights reserved.

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

See http://www.perl.com/perl/misc/Artistic.html