manpagez: man pages & more
man IO::InnerFile(3)
Home | html | info | man
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 (pdoru@kappa.ro).

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

       Currently maintained by David F. Skoll (dfs@roaringpenguin.com).



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

Mac OS X 10.6 - Generated Thu Sep 17 20:12:20 CDT 2009
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.