man > IO::Lines

man perldoc info pydoc3 ri search

📛 NAME

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

🚀 Quick Reference

Use Case	Command	Description
Create an IO::Lines object from an array	IO::Lines->new(\@array)	Opens the array for reading/writing lines
Create for writing to a new array	IO::Lines->new()	Creates an empty array; lines can be appended
Tie a handle to an array of lines	tie *HANDLE, 'IO::Lines', \@array	Makes HANDLE behave like a filehandle on the array
Read a line	$line = or $io->getline()	Returns next line (with "\n" except possibly last)
Print lines	print $io @lines	Auto-breaks data at newlines; each element ends with "\n"

📋 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: 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

Dianne Skoll (dfs AT roaringpenguin.com).

📝 Principal author

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

🤝 Other contributors

• Morris M. Siegel, for his $/ patch and the new getlines().
• Doug Wilson, for the IO::Handle inheritance and automatic tie-ing.

📛 NAME 🚀 Quick Reference 📋 SYNOPSIS 📖 DESCRIPTION 🏷️ VERSION 👥 AUTHORS