Rocco Caputo > App-PipeFilter-0.005 > App::PipeFilter::Role::Reader::Sysread

Download:
App-PipeFilter-0.005.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.005   Source  

NAME ^

App::PipeFilter::Role::Reader::Sysread - read input streams in large chunks for speed

VERSION ^

version 0.005

SYNOPSIS ^

  package App::PipeFilter::Generic::Json;

  use Moose;

  extends 'App::PipeFilter::Generic';

  with qw(
    App::PipeFilter::Role::Reader::Sysread
    App::PipeFilter::Role::Input::Json
    App::PipeFilter::Role::Output::Json
  );

  1;

DESCRIPTION ^

App::PipeFilter::Role::Reader::Sysread implements a read_input() method that returns large chunks of input at a time. Input chunks are arbitrary; they do not honor the structure of the files being read.

App::PipeFilter::Generic uses read_input() to consume data from its current input filehandle.

This role is faster than App::PipeFilter::Role::Reader::LineByLine, but it may not work with all devices. Some data formats may be easier to work with on a line-by-line basis.

PUBLIC METHODS ^

read_input FILEHANDLE, SCALAR_REF

read_input() reads the next chunk of data from a FILEHANDLE using Perl's built-in sysread() function. It appends this chunk of data to the buffer pointed at by a SCALAR_REF. It returns sysread()'s result.

SEE ALSO ^

You may read this module's implementation in its entirety at

  perldoc -m App::PipeFilter::Role::Reader::Sysread

App::PipeFilter has top-level documentation including a table of contents for all the libraries and utilities included in the project.

BUGS ^

https://rt.cpan.org/Public/Dist/Display.html?Name=App-PipeFilter

REPOSITORY ^

https://github.com/rcaputo/app-pipefilter

COPYRIGHT AND LICENSE ^

App::PipeFilter::Role::Reader::Sysread is Copyright 2011 by Rocco Caputo. All rights are reserved. App::PipeFilter::Role::Reader::Sysread is released under the same terms as Perl itself.

syntax highlighting: