1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
4 .\" ========================================================================
5 .de Sh \" Subsection heading
13 .de Sp \" Vertical space (when we can't use .PP)
17 .de Vb \" Begin verbatim text
22 .de Ve \" End verbatim text
26 .\" Set up some character translations and predefined strings. \*(-- will
27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28 .\" double quote, and \*(R" will give a right double quote. | will give a
29 .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30 .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
37 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
51 .\" If the F register is turned on, we'll generate index entries on stderr for
52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53 .\" entries marked with X<> in POD. Of course, you'll have to process the
54 .\" output yourself in some meaningful fashion.
57 . tm Index:\\$1\t\\n%\t"\\$2"
63 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
64 .\" way too many mistakes in technical documents.
68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69 .\" Fear. Run. Save yourself. No user-serviceable parts.
70 . \" fudge factors for nroff and troff
79 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
85 . \" simple accents for nroff and troff
95 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
102 . \" troff and (daisy-wheel) nroff accents
103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110 .ds ae a\h'-(\w'a'u*4/10)'e
111 .ds Ae A\h'-(\w'A'u*4/10)'E
112 . \" corrections for vroff
113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115 . \" for low resolution devices (crt and lpr)
116 .if \n(.H>23 .if \n(.V>19 \
129 .\" ========================================================================
131 .IX Title "IO::Lines 3"
132 .TH IO::Lines 3 "2005-02-10" "perl v5.8.7" "User Contributed Perl Documentation"
134 IO::Lines \- IO:: interface for reading/writing an array of lines
136 .IX Header "SYNOPSIS"
142 \& ### See IO::ScalarArray for details
145 .IX Header "DESCRIPTION"
146 This class implements objects which behave just like FileHandle
147 (or IO::Handle) objects, except that you may use them to write to
148 (or read from) an array of lines. They can be tiehandle'd as well.
150 This is a subclass of IO::ScalarArray
151 in which the underlying
152 array has its data stored in a line\-oriented\-format: that is,
153 every element ends in a \f(CW"\en"\fR, with the possible exception of the
154 final element. This makes \f(CW\*(C`getline()\*(C'\fR \fImuch\fR more efficient;
155 if you plan to do line-oriented reading/printing, you want this class.
157 The \f(CW\*(C`print()\*(C'\fR method will enforce this rule, so you can print
158 arbitrary data to the line\-array: it will break the data at
159 newlines appropriately.
161 See IO::ScalarArray for full usage and warnings.
164 $Id: Lines.pm,v 1.3 2005/02/10 21:21:53 dfs Exp $
167 .Sh "Primary Maintainer"
168 .IX Subsection "Primary Maintainer"
169 David F. Skoll (\fIdfs@roaringpenguin.com\fR).
170 .Sh "Principal author"
171 .IX Subsection "Principal author"
172 Eryq (\fIeryq@zeegee.com\fR).
173 President, ZeeGee Software Inc (\fIhttp://www.zeegee.com\fR).
174 .Sh "Other contributors"
175 .IX Subsection "Other contributors"
176 Thanks to the following individuals for their invaluable contributions
177 (if I've forgotten or misspelled your name, please email me!):
179 \&\fIMorris M. Siegel,\fR
180 for his $/ patch and the new \f(CW\*(C`getlines()\*(C'\fR.
183 for the IO::Handle inheritance and automatic tie\-ing.