man-pages/man3/IO::Lines.3pm.html
2021-03-31 01:06:50 +01:00

119 lines
2.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of IO::Lines</TITLE>
</HEAD><BODY>
<H1>IO::Lines</H1>
Section: User Contributed Perl Documentation (3pm)<BR>Updated: 2019-02-28<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
IO::Lines - IO:: interface for reading/writing an array of lines
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<PRE>
use IO::Lines;
### See IO::ScalarArray for details
</PRE>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
This class implements objects which behave just like FileHandle
(or IO::Handle) objects, except that you may use them to write to
(or read from) an array of lines. They can be tiehandle'd as well.
<P>
This is a subclass of IO::ScalarArray
in which the underlying
array has its data stored in a line-oriented-format: that is,
every element ends in a <TT>&quot;\n&quot;</TT>, with the possible exception of the
final element. This makes <TT>&quot;getline()&quot;</TT> <I>much</I> more efficient;
if you plan to do line-oriented reading/printing, you want this class.
<P>
The <TT>&quot;print()&quot;</TT> method will enforce this rule, so you can print
arbitrary data to the line-array: it will break the data at
newlines appropriately.
<P>
See IO::ScalarArray for full usage and warnings.
<A NAME="lbAE">&nbsp;</A>
<H2>VERSION</H2>
<TT>$Id:</TT> Lines.pm,v 1.3 2005/02/10 21:21:53 dfs Exp $
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHORS</H2>
<A NAME="lbAG">&nbsp;</A>
<H3>Primary Maintainer</H3>
Dianne Skoll (<I><A HREF="mailto:dfs@roaringpenguin.com">dfs@roaringpenguin.com</A></I>).
<A NAME="lbAH">&nbsp;</A>
<H3>Principal author</H3>
Eryq (<I><A HREF="mailto:eryq@zeegee.com">eryq@zeegee.com</A></I>).
President, ZeeGee Software Inc (<I><A HREF="http://www.zeegee.com">http://www.zeegee.com</A></I>).
<A NAME="lbAI">&nbsp;</A>
<H3>Other contributors</H3>
Thanks to the following individuals for their invaluable contributions
(if I've forgotten or misspelled your name, please email me!):
<P>
<I>Morris M. Siegel,</I>
for his $/ patch and the new <TT>&quot;getlines()&quot;</TT>.
<P>
<I>Doug Wilson,</I>
for the IO::Handle inheritance and automatic tie-ing.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="1"><A HREF="#lbAB">NAME</A><DD>
<DT id="2"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="3"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="4"><A HREF="#lbAE">VERSION</A><DD>
<DT id="5"><A HREF="#lbAF">AUTHORS</A><DD>
<DL>
<DT id="6"><A HREF="#lbAG">Primary Maintainer</A><DD>
<DT id="7"><A HREF="#lbAH">Principal author</A><DD>
<DT id="8"><A HREF="#lbAI">Other contributors</A><DD>
</DL>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:46 GMT, March 31, 2021
</BODY>
</HTML>