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

- NAME
- SYNOPSIS
- DESCRIPTION
- PUBLIC INTERFACE
  - new FILEHANDLE, [START, [LENGTH]]
  - set_length LENGTH
  - get_length
  - add_length NBYTES
  - set_start START
  - get_start
  - add_start NBYTES
  - binmode
  - close
  - flush
  - getc
  - getline
  - print LIST
  - printf LIST
  - read BUF, NBYTES
  - readline
  - seek OFFFSET, WHENCE
  - tell
  - write ARGS...
- VERSION
- AUTHOR

## 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 2.102 2001/08/17 02:06:33 eryq Exp $

## AUTHOR

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

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