IO::Lines(3)

💅 IO::Lines ✨

okay so bestie, welcome to IO::Lines(3) — it's a User Contributed Perl Documentation page and honestly it's giving "tiny module, big energy". Sit down, hydrate, let's go 🫶

---

🌸 NAME 🌸

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

like, literally, that's the whole vibe. an array. of lines. with IO on top.

---

✨ SYNOPSIS ✨

use IO::Lines;

### See IO::ScalarArray for details

that's it, that's the snippet 🌈 and yes, the comment is doing all the heavy lifting — go look at IO::ScalarArray for the full tea.

---

🦋 DESCRIPTION 🦋

Okay so picture this: this class makes objects that behave just like FileHandle (or IO::Handle) objects — except the twist is you can use them to write to (or read from) an array of lines 👑. It's "tiehandle" capable as well, which, slay.

This is a subclass of IO::ScalarArray where the underlying array keeps its data in a line-oriented format. Meaning: every element ends in a "\n" — with the possible exception of the final element 🙈. The way this makes getline() much more efficient?? iconic. So if you're planning on doing line-oriented reading/printing, this is the class you want, periodt.

The print() method will enforce this rule, so you can print arbitrary data to the line-array and it'll break the data at newlines appropriately 💅 no cap, it handles that for you.

See IO::ScalarArray for full usage and warnings — fr fr, go read it, the caveats live over there 🎀

---

⭐ 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). main character energy tbh 👑

---

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

---

k bye bestie, that's the whole page 💖 this one shipped as perl v5.42.0 dated 2020-06-04 — and that's the cute lil sign-off, catch you on the next manpage 🧚‍♀️🌷