NAME

IO::InnerFile - define a file inside another file

SYNOPSIS

    ### 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 1.4 2005/02/10 21:21:53 dfs Exp $

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

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

Currently maintained by Dianne Skoll (dfs@roaringpenguin.com).