git.maemo.org Git - dh-make-perl/blob - dev/arm/libio-stringy-perl/io-stringy-2.110/docs/IO/Lines.pm.html

   1 <HTML>
   2 <HEAD>
   3   <TITLE>IO::Lines 2.103</TITLE>
   4 </HEAD>
   5 <BODY
   6        bgcolor="#FFFFFF" link="#CC3366" vlink="#993366" alink="#FF6666">
   7 <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::Lines 2.103</H1>
   8 </A><UL>
   9 <LI> <A NAME="menu:NAME"><A HREF="#NAME">NAME</A></A>
  10 <LI> <A NAME="menu:SYNOPSIS"><A HREF="#SYNOPSIS">SYNOPSIS</A></A>
  11 <LI> <A NAME="menu:DESCRIPTION"><A HREF="#DESCRIPTION">DESCRIPTION</A></A>
  12 <LI> <A NAME="menu:VERSION"><A HREF="#VERSION">VERSION</A></A>
  13 <LI> <A NAME="menu:AUTHORS"><A HREF="#AUTHORS">AUTHORS</A></A>
  14 <UL>
  15 <LI> <A NAME="menu:Principal_author"><A HREF="#Principal_author">Principal author</A></A>
  16 <LI> <A NAME="menu:Other_contributors"><A HREF="#Other_contributors">Other contributors</A></A>
  17 </UL>
  18 </UL>
  19
  20
  21 <P><HR>
  22 <A NAME="NAME"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> NAME</H2></A>
  23
  24
  25 <P>IO::Lines - IO:: interface for reading/writing an array of lines
  26
  27
  28
  29 <P><HR>
  30 <A NAME="SYNOPSIS"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> SYNOPSIS</H2></A>
  31
  32 <FONT SIZE=3 FACE="courier"><PRE>
  33     use IO::Lines;
  34 </PRE></FONT>
  35 <FONT SIZE=3 FACE="courier"><PRE>
  36     ### See IO::ScalarArray for details
  37 </PRE></FONT>
  38
  39
  40 <P><HR>
  41 <A NAME="DESCRIPTION"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> DESCRIPTION</H2></A>
  42
  43
  44 <P>This class implements objects which behave just like FileHandle
  45 (or IO::Handle) objects, except that you may use them to write to
  46 (or read from) an array of lines.  They can be tiehandle'd as well.
  47
  48
  49 <P>This is a subclass of <A HREF="../IO/ScalarArray.pm.html">IO::ScalarArray</A>
  50 in which the underlying
  51 array has its data stored in a line-oriented-format: that is,
  52 every element ends in a <CODE>&quot;\n&quot;</CODE>, with the possible exception of the
  53 final element.  This makes <CODE>getline()</CODE> <I>much</I> more efficient;
  54 if you plan to do line-oriented reading/printing, you want this class.
  55
  56
  57 <P>The <CODE>print()</CODE> method will enforce this rule, so you can print
  58 arbitrary data to the line-array: it will break the data at
  59 newlines appropriately.
  60
  61
  62 <P>See <A HREF="../IO/ScalarArray.pm.html">IO::ScalarArray</A> for full usage and warnings.
  63
  64
  65
  66 <P><HR>
  67 <A NAME="VERSION"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> VERSION</H2></A>
  68
  69
  70 <P>$Id: Lines.pm,v 2.103 2001/08/09 08:04:44 eryq Exp $
  71
  72
  73
  74 <P><HR>
  75 <A NAME="AUTHORS"><H2><A HREF="#__TOP__"><IMG SRC="icons/h1bullet.gif" ALT="Top" BORDER="0"></A> AUTHORS</H2></A>
  76
  77
  78
  79 <P><HR>
  80 <A NAME="Principal_author"><H3><A HREF="#__TOP__"><IMG SRC="icons/h2bullet.gif" ALT="Top" BORDER="0"></A> Principal author</H3></A>
  81
  82
  83 <P>Eryq (<I><FILE><A HREF="mailto:eryq@zeegee.com">eryq@zeegee.com</A></FILE></I>).
  84 President, ZeeGee Software Inc (<I><FILE><A HREF="http://www.zeegee.com">http://www.zeegee.com</A></FILE></I>).
  85
  86
  87
  88 <P><HR>
  89 <A NAME="Other_contributors"><H3><A HREF="#__TOP__"><IMG SRC="icons/h2bullet.gif" ALT="Top" BORDER="0"></A> Other contributors</H3></A>
  90
  91
  92 <P>Thanks to the following individuals for their invaluable contributions
  93 (if I've forgotten or misspelled your name, please email me!):
  94
  95
  96 <P><I>Morris M. Siegel,</I>
  97 for his $/ patch and the new <CODE>getlines()</CODE>.
  98
  99
 100 <P><I>Doug Wilson,</I>
 101 for the IO::Handle inheritance and automatic tie-ing.
 102
 103 <P><HR>
 104 <ADDRESS><FONT SIZE=-1>
 105 Generated Sun Dec 21 13:54:37 2003 by cvu_pod2html
 106 </FONT></ADDRESS>
 107 </FONT></BODY>
 108 </HTML>