bgcolor="#FFFFFF" link="#CC3366" vlink="#993366" alink="#FF6666"> ZeeGee Software

IO::InnerFile 2.102

This module is BETA code, which means that the interfaces are fairly stable BUT it has not been out in the community long enough to guarantee much testing. Use with caution! Please report any errors back to eryq@zeegee.com as soon as you can.


Top NAME

IO::InnerFile - define a file inside another file


Top SYNOPSIS

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


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


Top PUBLIC INTERFACE

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

Top set_length LENGTH

Top get_length

Top add_length NBYTES
Instance methods. Get/set the virtual length of the inner file.

Top set_start START

Top get_start

Top add_start NBYTES
Instance methods. Get/set the virtual start position of the inner file.

Top binmode

Top close

Top flush

Top getc

Top getline

Top print LIST

Top printf LIST

Top read BUF, NBYTES

Top readline

Top seek OFFFSET, WHENCE

Top tell

Top write ARGS...
Instance methods. Standard filehandle methods.


Top VERSION

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


Top AUTHOR

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

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


Generated Mon Aug 20 16:36:32 2001 by cvu_pod2html