TAP::PARSER::ITERATOR(3perl)

💖 TAP::Parser::Iterator — the lil base class energy behind every TAP source iterator 💖

okay so bestie, welcome to the 3perl manual for TAP::Parser::Iterator. This is the base class, the blueprint, the mother of all TAP source iterators. She's not doing the work herself — she's the vibe, the interface, the standard. 🎀

---

✨ VERSION ✨

Version 3.52 — yes she's grown, she's evolved, she's iconic.

---

🌈 SYNOPSIS 🌈

Subclassing? Say less. Here's the whole vibe:

# to subclass:
use TAP::Parser::Iterator ();
use base 'TAP::Parser::Iterator';
sub _initialize {
  # see TAP::Object...
}

sub next_raw { ... }
sub wait     { ... }
sub exit     { ... }

That's it, that's the blueprint. Copy it, make it yours. 🫶

---

🦋 DESCRIPTION 🦋

So here's the tea: this is a simple iterator base class that defines TAP::Parser's iterator API. That's literally her whole job. She sets the rules, you do the work.

And where do these iterators come from, you ask? They're typically created from TAP::Parser::SourceHandlers. That's the pipeline, iykyk. 💅

---

⭐ METHODS ⭐

👑 Class Methods 👑

• new — Create an iterator. Babygirl, this one is provided by TAP::Object, so it's already handled for you. Don't reinvent her.

💜 Instance Methods 💜

• next — iterate through it, of course. Obviously. Duh.

while ( my $item = $iter->next ) { ... }

• next_raw — okay listen, note: this method is abstract and should be overridden. 🚨 She's giving "placeholder energy" until you show up and implement her.

while ( my $item = $iter->next_raw ) { ... }

She iterates raw input — meaning without applying any fixes for quirky input syntax. No filter, no glow-up, straight from the source. 💀

• handle_unicode — if necessary, switch the input stream to handle unicode. Important detail bestie: this only has any effect for I/O handle based streams. The default implementation? Does nothing. Cute, low-effort, we respect it.
• get_select_handles — returns a list of filehandles that may be used upstream in a select() call, to signal that this Iterator is ready. 👀 If your iterator isn't handle-based, she should return an empty list — know your lane. The default implementation here also does nothing.
• wait — note: this method is abstract and should be overridden. ⚠️ Return the wait status for this iterator.

my $wait_status = $iter->wait;

• exit — note: this method is abstract and should be overridden. ⚠️ Return the exit status for this iterator.

my $wait_status = $iter->exit;

---

🧚 SUBCLASSING 🧚

Want the full overview? Go read "SUBCLASSING" in TAP::Parser. She's got the deep dive, we're just the trailer. 🎬

But fr fr — you must override the abstract methods as noted above. No skipping, no shortcuts, we see you. 👀

🌸 Example 🌸

TAP::Parser::Iterator::Array is probably the easiest example to follow. And honestly? There's not much point repeating it here. Go look at the source, bestie, she's right there. 🫶

---

🔥 SEE ALSO 🔥

• TAP::Object
• TAP::Parser
• TAP::Parser::Iterator::Array
• TAP::Parser::Iterator::Stream
• TAP::Parser::Iterator::Process

---

That's the whole page, bestie. This was TAP::Parser::Iterator, from perl v5.44.0, dated 2026-10-17. Stay iterating, stay iconic, slay the subclassing. periodt. 💅✨🎀