NAME
   PerlIO::via::Limit - PerlIO layer for length restrictions

SYNOPSIS
       use PerlIO::via::Limit;
       PerlIO::via::Limit->length(20);
       # - or -
       use PerlIO::via::Limit length => 20;

       # reading
       open( my $fh, "<:via(Limit)", $file );

       # writing
       open( my $fh, ">:via(Limit)", $file );

DESCRIPTION
   PerlIO::via::Limit implements a PerlIO layer that restricts length of
   stream.

CLASS METHODS
 length
   Limit length of stream. Default is undef that means unlimited.

 sensitive
   If set true value, an exception will be occurred when stream reaches
   limit of length. Default is false.

       use PerlIO::via::Limit sensitive => 1;

       open( my $in, "<:via(Limit)", $file ) or die;
       eval {
           while( <$in> ){
               # do something...
           }
       };if( $@ ){
           # "$in is trying to read exceeding the limit."
           warn "$@";
       }
       close $in or die;

   Note that the $@ is a Exception::Class object.

BUGS
   When the exception is thrown by sensitive option, the buffer for reading
   does not be filled.

SEE ALSO
   PerlIO::via

   Exception::Class

REPOSITORY
   PerlIO::via::Limit is hosted on github
   <https://github.com/hiroaki/PerlIO-via-Limit>

AUTHOR
   WATANABE Hiroaki <[email protected]>

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

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.