Math::NumSeq::Odd(3)

💅 Math::NumSeq::Odd

okay bestie, so this is the manual page for Math::NumSeq::Odd from the User Contributed Perl Documentation section (section 3, the library-calls one, iykyk) 🎀

---

✨ NAME ✨

Math::NumSeq::Odd — odd integers 💜

like. the odd ones. 1, 3, 5. not the even ones. we don't do those here (that's a different module, see SEE ALSO below, no spoilers 🫶)

---

🌸 SYNOPSIS 🌸

use Math::NumSeq::Odd;
my $seq = Math::NumSeq::Odd->new;
my ($i, $value) = $seq->next;

that's literally it. three lines and you're off. iconic behaviour tbh ⭐

---

🦋 DESCRIPTION 🦋

The odd integers, bestie:

1, 3, 5, 7, 9, 11, ...
starting i=0

so i=0 gives you 1, i=1 gives you 3, and so on forever. it's giving "infinite" and honestly? obsessed 🌈

---

🎀 FUNCTIONS 🎀

for the stuff that every single sequence class does the same way, go read "FUNCTIONS" in Math::NumSeq. that's the shared lore. 💖

• $seq = Math::NumSeq::Odd->new () — makes you a brand new sequence object and hands it back to you. fresh out the box, no cap.

🔥 Iterating

• $seq->seek_to_i($i) — moves where you are in the sequence over to $i. the very next time you call next() it's gonna hand you $i and the value that goes with it. main character energy, you decide where the story starts ✨
• $seq->seek_to_value($value) — nudges the current i around so that next() spits out $value when you call it. but — and this is the lil plot twist 🙈 — if $value happens to be an even integer, then you get the next higher even one instead. not a bug, just the vibe.

💀 Random Access

• $value = $seq->ith($i) — returns 2*$i + 1. that's the whole trick. multiply by two, add one, boom, odd number 💅
• $bool = $seq->pred($value) — returns true if $value is odd. that's it. that's the predicate. no notes.
• $i = $seq->value_to_i_ceil($value)
• $i = $seq->value_to_i_floor($value)

both of these return (value-1)/2, except one rounds up and one rounds down to the next integer. ceil goes up, floor goes down. you got this 🧚

• $i = $seq->value_to_i_estimate($value) — gives you an estimate of the i that corresponds to $value. it's an estimate, bestie, not a promise 🍓

---

🌟 SEE ALSO 🌟

• Math::NumSeq
• Math::NumSeq::Even
• Math::NumSeq::All

(the whole friend group 🫶)

---

👑 HOME PAGE 👑

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

go say hi ✨

---

💖 LICENSE 💖

Copyright 2010, 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/>.

ok so real talk: that "WITHOUT ANY WARRANTY" bit is not a joke, bestie — no promises, no guarantees, use it at your own risk 💀 and if you didn't get your copy of the GPL with the module, go grab it at <http://www.gnu.org/licenses/>. periodt.

---

and that's the whole page, babe 🎀 perl v5.42.0, dated 2025-07-25, page Math::NumSeq::Odd(3) — slay, stan, and go count some odd numbers 💜✨🦋