NAME

Text::APL::Writer - writer

DESCRIPTION

Write a template output to various destinations. Accepts a subroutine for a custom implementation.

Returns a reference to subroutine. When called accepts a chunk of template output. Chunk is undefined when template is fully processed. When received an undefined chunk one can close a file, drop the connection etc.

For example a writer to a file handle is implemented as:

        sub { print $output $_[0] };

The following destinations are implemented:

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

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

METHODS

build

Build a writer.