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>) {
...
}
DESCRIPTION
If you have a filehandle that can seek() and tell(), then you can open an IO::InnerFile on a range of the underlying file.
PUBLIC INTERFACE
- 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.
VERSION
$Id: InnerFile.pm,v 1.4 2005/02/10 21:21:53 dfs Exp $
AUTHOR
Original version by Doru Petrescu (pdoru@kappa.ro).
Documentation and by Eryq (eryq@zeegee.com).
Currently maintained by Dianne Skoll (dfs@roaringpenguin.com).