This manual page is for Mac OS X version 10.6

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.



IO::InnerFile(3)                     User Contributed Perl Documentation                    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 ([email protected]).

       Documentation and by Eryq ([email protected]).

       Currently maintained by David F. Skoll ([email protected]).



perl v5.8.9                                      2005-02-10                                 IO::InnerFile(3)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation to the Perl project. (See perlbug(1) for submission instructions.)
Bug reports
Report bugs in the functionality of the described tool or API to Apple through Bug Reporter and to the Perl project using perlbug(1).
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.