Text::Query::Solve(3)

💅 Text::Query::Solve — the base class for query resolution

okay so bestie, welcome to Text::Query::Solve(3) from the User Contributed Perl Documentation ✨ this is the literal blueprint page, the main character energy of the whole query-resolution family 🎀

---

🌸 NAME

Text::Query::Solve — the base class for query resolution, no cap 💖

---

✨ SYNOPSIS

here's the vibe, copy-paste it exactly pls 🙈

package Text::Query::SolveSource;

use Text::Query::Parse;

use vars qw(@ISA);

@ISA = qw(Text::Query::Solve);

---

🦋 DESCRIPTION

so this module hands you a virtual base class for query resolution 🌈 like it's the template, the blueprint, the ~foundation~ okurrr ✨

it defines the "match" and "matchscalar" methods — those are the ones your "Text::Query" object calls when it wants to actually apply a query on a data source 💅 periodt.

---

👑 METHODS

🍓 match (EXPR [TARGET])

okay so here's the tea, it depends on what TARGET is:

• if TARGET is a scalar, match returns a true value when the data source that TARGET specifies matches the EXPR query expression ✅ and if you don't give it a TARGET at all? it matches against $_ instead, iykyk 🙈
• if TARGET is an array, match returns a (possibly empty) list of all the matching elements 💖 and lowkey the cool part: if the elements of the array are references to sub-arrays, the match happens against the first element of each sub-array — which lets you attach literally any extra info (filenames, bestie, filenames 🎀) to each data source you're matching 🦋
• if TARGET is a reference to an array, match returns a reference to a (possibly empty) list of all matching elements ⭐

🧚 matchscalar (EXPR [TARGET])

behaves just like "MATCH" when TARGET is a scalar or isn't given at all 💜 so like, same energy, no drama.

---

🌟 SEE ALSO

• Text::Query(3) — go read it, it's giving essential 🫶

---

💀 AUTHORS

• Eric Bohlman (ebohlman@netcom.com) 👑
• Loic Dachary (loic@senga.org) 👑

---

😭 POD ERRORS

ngl, the doc had some coding errors and they are explained right here, no hiding it 💀

Around line 98:

You forgot a '=back' before '=head1'

bestie you literally forgot a '=back' before '=head1' — the POD parser is not okay about it 😭

---

anyway that's the whole page, perl v5.38.2, dated 2024-07-13 — mwah, slay, go match some stuff 💅✨🌸