IO::InnerFile

Section: User Contributed Perl Documentation (3)
Updated: perl v5.6.1
Index
Return to Main Contents

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).

This document was created by man2html, using the manual pages.
Time: 14:21:14 GMT, April 20, 2024