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 File
Handle (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 under
lying array has its data stored in a line-oriented-format:
that is, every element ends in a "0, with the possible
exception of the final element. This makes "getline()"
much more efficient; if you plan to do line-oriented read
ing/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 2.103 2001/08/09 08:04:44 eryq Exp $

AUTHORS

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 "get lines()".

Doug Wilson, for the IO::Handle inheritance and automatic tie-ing.
Copyright © 2010-2025 Platon Technologies, s.r.o.           Home | Man pages | tLDP | Documents | Utilities | About
Design by styleshout