NAME

Doc::Perlish::Reader - abstaction for stream-ish data input

SYNOPSIS

my $reader = Doc::Perlish::Reader->new($where);

# or "lines", "characters", or a regex
$reader->give_me("paragraphs");

while (!$reader->eof) {
    my $data = $reader->next;

    # do something with $data...

    # if you didn't want a chunk, put it back.
    if ($unwanted) {
        $reader->unget($data);
    }
}

# if you want to use it again.
$reader->reset;

DESCRIPTION

A Doc::Perlish reader is an abstraction around the job of pulling in data from a file. It is here so that other input for information can choose to emulate an IO::All, or this class.