1IO::InnerFile(3)      User Contributed Perl Documentation     IO::InnerFile(3)
2
3
4

NAME

6       IO::InnerFile - define a file inside another file
7

SYNOPSIS

9           ### Read a subset of a file:
10           $inner = IO::InnerFile->new($fh, $start, $length);
11           while (<$inner>) {
12               ...
13           }
14

DESCRIPTION

16       If you have a filehandle that can seek() and tell(), then you can open
17       an IO::InnerFile on a range of the underlying file.
18

PUBLIC INTERFACE

20       new FILEHANDLE, [START, [LENGTH]]
21           Class method, constructor.  Create a new inner-file opened on the
22           given FILEHANDLE, from bytes START to START+LENGTH.  Both START and
23           LENGTH default to 0; negative values are silently coerced to zero.
24
25           Note that FILEHANDLE must be able to seek() and tell(), in addition
26           to whatever other methods you may desire for reading it.
27
28       set_length LENGTH
29       get_length
30       add_length NBYTES
31           Instance methods.  Get/set the virtual length of the inner file.
32
33       set_start START
34       get_start
35       add_start NBYTES
36           Instance methods.  Get/set the virtual start position of the inner
37           file.
38
39       binmode
40       close
41       flush
42       getc
43       getline
44       print LIST
45       printf LIST
46       read BUF, NBYTES
47       readline
48       seek OFFFSET, WHENCE
49       tell
50       write ARGS...
51           Instance methods.  Standard filehandle methods.
52

VERSION

54       $Id: InnerFile.pm,v 1.4 2005/02/10 21:21:53 dfs Exp $
55

AUTHOR

57       Original version by Doru Petrescu (pdoru@kappa.ro).
58
59       Documentation and by Eryq (eryq@zeegee.com).
60
61       Currently maintained by David F. Skoll (dfs@roaringpenguin.com).
62
63
64
65perl v5.12.0                      2005-02-10                  IO::InnerFile(3)