Index for Section 3

Alphabetical listing for I

Bottom of page

IO::InnerFile(3)
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 David F. Skoll (dfs@roaringpenguin.com).

Index for Section 3

Alphabetical listing for I

Top of page