TEST2::COMPARE::ORDEREDSUBSET(3perl)

📦
version 5.44.0 · 8 versions
, in arch rolling

💅 Test2::Compare::OrderedSubset — from the Test2::...dSubset(3perl) page

okay bestie, pull up a chair, we're doing Perl internals today and honestly? it slaps.

✨ NAME ✨

Test2::Compare::OrderedSubset — the internal representation of an ordered subset. yep. that's the whole job description. 🎀

🦋 DESCRIPTION 🦋

so here's the vibe. this module exists to check that an array has all the expected items in the expected order. that's it, that's the girl's whole personality. 💖

and the way it does that? it ignores any unexpected items that got mixed into the array. extra stuff shows up? not her problem, she doesn't even look. 🙈

the only thing she cares about is that every expected value is present and in order. everything else? noise. literally just background static. she's the main character, the other array elements are just extras in her story. 👑

🌸 METHODS 🌸

  • $ref = $arr->inref() — if this instance got built from an actual, real, honest-to-god array, this hands you back the reference to that array. if it wasn't built from one… well, no reference for you. 🫶
  • $arrayref = $arr->items()
  • $arr->set_items($arrayref) — this is the whole list of expected items, in order. getter reads it, setter sets it. iconic duo behavior. ✨
  • $name = $arr->name() — always, always, returns the string "<ORDERED SUBSET>". no mood swings, no surprises, just a name that never changes. 💅
  • $bool = $arr->verify(got => $got, exists => $bool) — checks whether $got is an array reference or not. yes or no, bestie, that's the whole question. ⭐
  • $arr->add_item($item) — drops one more item onto the pile of values that need checking. 🍓
  • @deltas = $arr->deltas(got => $got, convert => \&convert, seen => \%seen) — here's where the detective work happens: it finds the differences between the expected array values and the ones sitting inside the $got arrayref. tell me why this is the most dramatic method here. 😭

🌈 SOURCE 🌈

the source code repository for Test2-Suite lives right here, go be nosy:

https://github.com/Test-More/test-more/

👑 MAINTAINERS 👑

Chad Granum <exodist@cpan.org>

💜 AUTHORS 💜

Chad Granum <exodist@cpan.org>

Copyright Chad Granum <exodist@cpan.org>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://dev.perl.org/licenses/

okay that's the whole page, you ate that fr fr 💖 this was pulled from the perl v5.44.0 docs dated 2026-10-17 and the header up top there said Test2:...dSubset(3perl) — and yes the manual name really is squished like that, don't ask, it's giving compression algorithm. mwah, go forth and order your subsets. 🦋✨

📦 where this page comes from