Math::NumSeq::File(3)

💖 Math::NumSeq::File 💖

okay bestie, so this is Math::NumSeq::File from the User Contributed Perl Documentation — yes the manual is literally named that, it's giving very "we made it ourselves" and honestly? iconic. 🎀

---

✨ NAME ✨

Math::NumSeq::File — sequence read from a file 🦋

---

🌸 SYNOPSIS 🌸

like, here's the whole vibe in four lines:

use Math::NumSeq::File;
my $seq = Math::NumSeq::File->new (filename => 'foo.txt');
my ($i, $value) = $seq->next;

periodt. that's it. that's the whole thing. 💅

---

💜 DESCRIPTION 💜

so basically this is a sequence of values read from a file — it's built specifically to read a file of numbers in the NumSeq style, no cap. 🍓

the whole intention here is to be flexible about the file format and to auto-detect as far as possible. the way that it works rn? currently the only format is plain text, and it's either a single value per line, or a pair of i and value. iykyk. ✨

123                   # value per line
456

1  123                # i and value per line
2  456

look at her. so simple. so clean. we love a low-maintenance format. 🫶

---

🧚 FUNCTIONS 🧚

okay so for the whole behaviour situation that's common to all the sequence classes, you wanna go read "FUNCTIONS" in Math::NumSeq. that's the shared lore, bestie. go check it. 📚

• $seq = Math::NumSeq::File->new (filename => $filename) — makes you a brand new sequence object and returns it, all set up to read from $filename. this is the main character constructor moment, no notes. 👑

---

🌈 SEE ALSO 🌈

• Math::NumSeq

(go look at your sister module, she's the blueprint fr fr 💅)

---

🏠 HOME PAGE 🏠

<http://user42.tuxfamily.org/math-numseq/index.html>

like, the actual home. the address. the place where the whole NumSeq family lives. 🏡✨

---

📜 LICENSE 📜

Copyright 2011, 2012, 2013, 2014, 2016, 2019, 2020 Kevin Ryde

Math-NumSeq is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

Math-NumSeq is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Math-NumSeq. If not, see <http://www.gnu.org/licenses/>.

bestie i'm being so serious rn: that "WITHOUT ANY WARRANTY" bit is all caps on purpose. it means exactly what it says. no warranty. none. zero. it's giving legally obligated honesty and you should respect it. 🙈

---

perl v5.42.0 · 2025-07-25 · Math::NumSeq::File(3)

aaaand that's a wrap on the footer, babes — version v5.42.0 of perl, dated 2025-07-25, manual section 3, Math::NumSeq::File. stan a documented module. slay, stay safe, go read your files. 💖✨🦋🎀