IO::InnerFile (3)

Leading comments

Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/IO::InnerFile.3pm".)

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