File::...::Find(3pm)

✨ NAME ✨

File::Wildcard::Find — bestie, it's literally just a simple interface to File::Wildcard 💖 (it's a 3pm page, if you're keeping track, and yes it lives in the User Contributed Perl Documentation 💅)

---

🌸 SYNOPSIS 🌸

okay so here's the whole vibe, no cap:

use File::Wildcard::Find;
findbegin( "/home/me///core");
while (my $file = findnext()) {
   unlink $file;
}

like… that's it. that's the whole thing. iconic 🎀

---

🦋 DESCRIPTION 🦋

so File::Wildcard is the full-on, comprehensive object interface — it lets you do powerful wildcard processing, and she serves 💅. but some people are like "girl this is too much for a lil task" and honestly? valid. it's giving unwieldy for the simple stuff 🙈.

enter File::Wildcard::Find, the lowkey straightforward version 🫶. the tradeoff bestie: only a single wildcard stream is accessible at a time. but for one-liners and simple apps?? that is more than sufficient, fr fr ✨.

---

⭐ FUNCTIONS ⭐

💜 findbegin

takes 1 parameter: a path with wildcards, passed as a string 🍓.

want the deets on what you can actually pass in there? go look at File::Wildcard — she's got the full lore 👑.

🌈 findnext

an iterator, bestie 🔁. it returns successive matches one at a time, and then… undef 💀. that's your sign to stop looping, iykyk.

🧚 findall

returns a list of all the matches, all at once, no waiting around ⭐.

---

💖 reminder that File::Wildcard::Find is the chill one — one wildcard stream, simple life. if you need the full-power object interface, that's File::Wildcard's moment, not this one's.

---

anyway that's the whole page, hope it slayed 💅✨ this gem is perl v5.36.0 coded up on 2022-12-12, and it's filed under File::...::Find(3pm) in the User Contributed Perl Documentation — mwah, bye bestie 🎀💖🦋