blob: b0f3a5b69d2687039d3437a3a2e3bfd073f8830a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
<HTML>
<HEAD>
<TITLE>IO::InnerFile</TITLE>
</HEAD>
<BODY
bgcolor="#FFFFFF" link="#CC3366" vlink="#993366" alink="#FF6666">
<FONT FACE="sans-serif" SIZE=-1><A HREF="http://www.zeegee.com" TARGET="_top"><IMG SRC="icons/zeegee.gif" ALT="ZeeGee Software" ALIGN="RIGHT" BORDER="0"></A><A NAME="__TOP__"><H1>IO::InnerFile</H1>
</A><UL>
<LI> <A HREF="#NAME">NAME</A>
<LI> <A HREF="#SYNOPSIS">SYNOPSIS</A>
<LI> <A HREF="#DESCRIPTION">DESCRIPTION</A>
<LI> <A HREF="#PUBLIC_INTERFACE">PUBLIC INTERFACE</A>
<LI> <A HREF="#AUTHOR">AUTHOR</A>
</UL>
</A>
<P><HR>
<A NAME="NAME"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> NAME</H2></A>
<P>IO::InnerFile - define a file inside another file
<P><HR>
<A NAME="SYNOPSIS"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> SYNOPSIS</H2></A>
<FONT SIZE=3 FACE="courier"><PRE>
### Read a subset of a file:
$inner = IO::InnerFile->new($fh, $start, $length);
while (<$inner>) {
...
}
</PRE></FONT>
<P><HR>
<A NAME="DESCRIPTION"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> DESCRIPTION</H2></A>
<P>If you have a filehandle that can seek() and tell(), then you
can open an IO::InnerFile on a range of the underlying file.
<P><HR>
<A NAME="PUBLIC_INTERFACE"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> PUBLIC INTERFACE</H2></A>
<DL>
<P><DT><B><A NAME="item:new">new FILEHANDLE, [START, [LENGTH]]</A></B></DT>
<DD>
<I>Class method, constructor.</I>
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.
<P>Note that FILEHANDLE must be able to seek() and tell(), in addition
to whatever other methods you may desire for reading it.
<P><DT><B><A NAME="item:set_length">set_length LENGTH</A></B></DT>
<DD>
<P><DT><B><A NAME="item:get_length">get_length</A></B></DT>
<DD>
<P><DT><B><A NAME="item:add_length">add_length NBYTES</A></B></DT>
<DD>
<I>Instance methods.</I>
Get/set the virtual length of the inner file.
<P><DT><B><A NAME="item:set_start">set_start START</A></B></DT>
<DD>
<P><DT><B><A NAME="item:get_start">get_start</A></B></DT>
<DD>
<P><DT><B><A NAME="item:add_start">add_start NBYTES</A></B></DT>
<DD>
<I>Instance methods.</I>
Get/set the virtual start position of the inner file.
<P><DT><B><A NAME="item:binmode">binmode</A></B></DT>
<DD>
<P><DT><B><A NAME="item:close">close</A></B></DT>
<DD>
<P><DT><B><A NAME="item:flush">flush</A></B></DT>
<DD>
<P><DT><B><A NAME="item:getc">getc</A></B></DT>
<DD>
<P><DT><B><A NAME="item:getline">getline</A></B></DT>
<DD>
<P><DT><B><A NAME="item:print">print LIST</A></B></DT>
<DD>
<P><DT><B><A NAME="item:printf">printf LIST</A></B></DT>
<DD>
<P><DT><B><A NAME="item:read">read BUF, NBYTES</A></B></DT>
<DD>
<P><DT><B><A NAME="item:readline">readline</A></B></DT>
<DD>
<P><DT><B><A NAME="item:seek">seek OFFFSET, WHENCE</A></B></DT>
<DD>
<P><DT><B><A NAME="item:tell">tell</A></B></DT>
<DD>
<P><DT><B><A NAME="item:write">write ARGS...</A></B></DT>
<DD>
<I>Instance methods.</I>
Standard filehandle methods.
</DL>
<P><HR>
<A NAME="AUTHOR"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> AUTHOR</H2></A>
<P>Original version by Doru Petrescu (pdoru@kappa.ro).
<P>Documentation and current maintenance by Eryq (eryq@zeegee.com).
<P><HR>
<ADDRESS><FONT SIZE=-1>
Generated Thu Sep 28 02:35:46 2000 by cvu_pod2html
</FONT></ADDRESS>
</FONT></BODY>
</HTML>
|
