io::innerfile(3)

NAME

IO::InnerFile - define a file inside another file

### Read a subset of a file:
$inner = IO::InnerFile->new($fh, $start, $length);
while (<$inner>) {
    ...
}

If you have a filehandle that can seek() and tell(), then you can open an IO::InnerFile on a range of the underlying
file.

new FILEHANDLE, [START, [LENGTH]]: Class method, constructor. Create a new inner-file opened on the given FILEHANDLE, from bytes START to
START+LENGTH. Both START and LENGTH default to 0;
negative values are silently coerced to zero.; Note that FILEHANDLE must be able to seek() and
tell(), in addition to whatever other methods you may
desire for reading it.
set_length LENGTH get_length add_length NBYTES: Instance methods. Get/set the virtual length of the inner file.
set_start START get_start add_start NBYTES: Instance methods. Get/set the virtual start position of the inner file.
binmode close flush getc getline print LIST printf LIST read BUF, NBYTES readline seek OFFFSET, WHENCE tell write ARGS...: Instance methods. Standard filehandle methods.

$Id: InnerFile.pm,v 2.102 2001/08/17 02:06:33 eryq Exp $

Original version by Doru Petrescu (pdoru@kappa.ro).

Documentation and current maintenance by Eryq
(eryq@zeegee.com).