This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

IO::Lines(3)                         User Contributed Perl Documentation                        IO::Lines(3)



NAME
       IO::Lines - IO:: interface for reading/writing an array of lines

SYNOPSIS
           use IO::Lines;

           ### See IO::ScalarArray for details

DESCRIPTION
       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.

       This is a subclass of IO::ScalarArray in which the underlying array has its data stored in a line-oriented-format: lineoriented-format:
       oriented-format: that is, every element ends in a "\n", with the possible exception of the final
       element.  This makes "getline()" much more efficient; if you plan to do line-oriented
       reading/printing, you want this class.

       The "print()" method will enforce this rule, so you can print arbitrary data to the line-array: it
       will break the data at newlines appropriately.

       See IO::ScalarArray for full usage and warnings.

VERSION
       $Id: Lines.pm,v 1.3 2005/02/10 21:21:53 dfs Exp $

AUTHORS
       Primary Maintainer

       David F. Skoll (dfs@roaringpenguin.com).

       Principal author

       Eryq (eryq@zeegee.com).  President, ZeeGee Software Inc (http://www.zeegee.com)

       Other contributors

       Thanks to the following individuals for their invaluable contributions (if I've forgotten or
       misspelled your name, please email me!):

       Morris M. Siegel, for his $/ patch and the new "getlines()".

       Doug Wilson, for the IO::Handle inheritance and automatic tie-ing.



perl v5.8.8                                      2005-02-10                                     IO::Lines(3)