/ 
Text-APL-0.09
River stage zero No dependents
/ Text::APL::Reader

NAME

Text::APL::Reader - reader

DESCRIPTION

Reads a template from various sources. Accepts a subroutine for a custom implementation.

Returns a reference to subroutine. When called accepts another reference to subroutine that is called upon receiving a chunk of the template.

For example a reader from a scalar reference is implemented as:

$reader = sub {
    my ($cb) = @_;

    $cb->(${$input_string});
    $cb->();
};

The first call on cb notifies Text::APL about the template chunk and second without arguments notifies Text::APL about EOF.

The following sources are implemented:

$reader->(\$scalar);
$reader->($filename);
$reader->($filehandle);
$reader->(sub {...custom code...});

Custom subroutines are used for non-blocking template reading. See examples/ directory for an example using IO::AIO for non-blocking template reading.

METHODS

build

Build a reader.