---
name: "IO::Lines"
section: "3pm"
platform: "linux"
package: "perl-io-stringy"
version: "2.113-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/IO::Lines"
---

# IO::Lines(3pm)

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

## 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.  `"tiehandle"` capable 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 $

## AUTHOR

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

## CONTRIBUTORS

Dianne Skoll (*dfs@roaringpenguin.com*).

## COPYRIGHT & LICENSE

Copyright (c) 1997 Erik (Eryq) Dorfman, ZeeGee Software, Inc. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.