read(3pm)

💖 read(3pm) 💖

okay bestie, welcome to OpaL::read — a Perl extension for reading files and commands, straight out of the User Contributed Perl Documentation collection. it's giving "tiny module, big helper energy" ✨

---

🌸 NAME 🌸

OpaL::read — Perl extension for reading files and commands. that's it, that's the whole vibe 🫶

---

🎀 SYNOPSIS 🎀

use OpaL::read qw(functions);

no functions or variables are exported automatically, so you have to specify them here yourself. the module is not gonna read your mind, bestie, you gotta ask 💅

---

🦋 DESCRIPTION 🦋

OpaL::read is used for reading files and commands. that's the whole job description and honestly? iconic ✨

all functions are autoloaded, so they will not be loaded into memory if you have not used them before. it's the "show up only when summoned" lifestyle and we respect it 💅

---

👑 FUNCTIONS 👑

💜 readfile

reads the content of the specified file and returns a list with all the lines. every single line, no skimping 🍓

USAGE:

@foo = "readfile"($filename);

---

🌸 readfileline

reads the first line of the specified file and returns a scalar with that line. just the one. the opening line, the main character 🎀

USAGE:

$foo = "readfileline"($filename);

---

⭐ readscalarfile

reads the content of the specified file and returns a scalar with the entire content. the whole thing, in one variable, no cap 💖

USAGE:

$foo = "readscalarfile"("filename");

---

🔥 readcommand

reads the content from the output of the specified command and returns a list with all the lines. yes bestie, we're running commands and reading what they say back 🌈

USAGE:

@foo = "readcommand"("command");

---

🧚 readcommandline

reads the first line from the output of the specified command and returns a scalar with that line. one line only, blink and it's over 😭

USAGE:

$foo = "readcommandline"("command)";

---

💀 readscalarfile

reads the content for the output of the specified file and returns a scalar with the entire content.

not me pointing out that this heading says readscalarfile but the usage line calls readscalarcommand 🫠 the manpage said what it said, and we are keeping it exactly as written. no editing the sacred text, periodt.

USAGE:

$foo = "readscalarcommand"($command);

---

🫶 AUTHOR 🫶

Ola Lundqvist <ola@inguza.com> — the icon who wrote all this 💜

---

🌈 SEE ALSO 🌈

• perl(1).

---

that's the whole page, bestie 💖 this was read(3pm), perl v5.40.1, dated 2025-12-17 — mwah, slay, go read some files 📁✨