Attean...quence(3pm)

💖 NAME 💖

okay bestie, this is the Attean::IteratorSequence(3pm) page from the User Contributed Perl Documentation, and it's giving main-character iterator energy 💅 The class is Attean::IteratorSequence — an iterator implementation backed by zero or more sub-iterators. periodt.

---

✨ VERSION ✨

This document describes Attean::IteratorSequence version 0.035 💖

---

🎀 SYNOPSIS 🎀

use v5.14;
use Attean;
my $iter = Attean::IteratorSequence->new(iterators => [$iter1, $iter2]);

---

🌸 DESCRIPTION 🌸

The Attean::IteratorSequence class represents a typed iterator that's backed by zero or more sub-iterators. When you iterate over it, it returns all the elements of all of its sub-iterators, in order, before returning undef. It conforms to the Attean::API::Iterator role, no cap 🦋

The Attean::IteratorSequence constructor requires two named arguments — it's lowkey needy in the best way:

• iterators — an array reference containing zero or more Attean::API::Iterator objects.
• item_type — a string representing the type of the items that will be returned from the iterator.

---

💅 METHODS 💅

🌟 next

Returns the iterator's next item, or undef upon reaching the end of iteration. iconic behavior, honestly.

🌟 push( $iterator )

Adds the new $iterator to the end of the array of sub-iterators.

After this call, $iterator will be owned by the IteratorSequence, so making any method calls on $iterator after this point may produce unexpected results. bestie, do not touch it after handing it over — that's the vibe check 💀

---

😭 BUGS 😭

Please report any bugs or feature requests through the GitHub web interface at https://github.com/kasei/attean/issues. fr fr, they want the feedback 💖

---

🦋 SEE ALSO 🦋

No entries are listed under SEE ALSO in the source — it's giving minimalist, bestie 🦋

---

👑 AUTHOR 👑

Gregory Todd Williams <gwilliams@cpan.org> 👑

---

🌈 COPYRIGHT 🌈

The legal tea is: Copyright (c) 2014--2022 Gregory Todd Williams. And also: This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay and share-alike 💅

---

footer sign-off: perl v5.40.0, dated 2025-01-26 — that's the source/version and date, and that's the whole page, bestie. you ate ✨💖