Clownf...terator(3pm)

💖 Clownf...terator(3pm) 💖

okay so bestie, this is the Clownfish::HashIterator page — it lives in the User Contributed Perl Documentation, section 3pm. it's giving "how do i walk through a hashtable without losing my mind" and honestly? iconic. 🎀

---

✨ NAME ✨

Clownfish::HashIterator — Hashtable Iterator. that's it, that's the whole vibe. 💅

---

✨ SYNOPSIS ✨

the way you literally just loop and vibe:

my $iter = Clownfish::HashIterator->new($hash);
while ($iter->next) {
    my $key   = $iter->get_key;
    my $value = $iter->get_value;
}

---

✨ DESCRIPTION ✨

okay so... there's literally nothing here. the section exists, it's just empty. no cap. main character silence. 🤫✨

---

✨ CONSTRUCTORS ✨

🦋 new

my $iter = Clownfish::HashIterator->new($hash);

Return a HashIterator for hash. boom. that's your iterator, bestie. 🫶

---

✨ METHODS ✨

🌸 next

my $bool = $hash_iterator->next();

Advance the iterator to the next key-value pair. lowkey the whole point of this class.

Returns: true if there's another key-value pair, false if the iterator is exhausted. when it says false, it's done-done. 💀

🌸 get_key

my $string = $hash_iterator->get_key();

Return the key of the current key-value pair. and listen — it is not allowed to call this method before next() was called for the first time, or after the iterator was exhausted. so like, don't be messy. 🙈

🌸 get_value

my $obj = $hash_iterator->get_value();

Return the value of the current key-value pair. same rules, same energy: it is not allowed to call this method before next() was called for the first time, or after the iterator was exhausted. fr fr. 😭

---

✨ INHERITANCE ✨

Clownfish::HashIterator isa Clownfish::Obj. yes queen, it knows its lineage. 👑

---

no cap, the rules about calling get_key and get_value at the wrong time are real — treat them like a hard boundary, not a suggestion. 🫶

---

and that's the whole page, bestie!! 💖 this one came from perl v5.42.3, dated 2026-09-02, and it's the Clownf...terator(3pm) page. slay, go iterate something. ✨🎀🦋