subs(3perl)

💅 subs — the Perl pragma that predeclares subroutine names 💅

okay bestie, welcome to subs (that's subs(3perl) for the formal girlies) — part of the Perl Programmers Reference Guide. it's short, it's sweet, and it's here to let you call your subroutines before they even exist. main character energy fr fr. ✨

---

✨ SYNOPSIS ✨

use subs qw(frob);
frob 3..10;

like. that's it. that's the whole vibe. 🎀

---

🌸 DESCRIPTION 🌸

so what's it doing? it predeclares every subroutine whose name you put in that list — which means you get to use them without parentheses, as list operators, even before they're actually declared. yes girl, calling subs that don't exist yet. iconic behavior honestly. 💅

⚠️ okay now the important part, don't scroll past this: Unlike pragmas that mess with the $^H hints variable, the use vars and use subs declarations are not lexically scoped to the block they appear in. they affect the entire package they show up in. the whole thing. the entire kingdom. 👑 And nope — you cannot rescind these declarations with no vars or no subs. once it's declared, it's declared. no take-backs, no undo button, no "oops I changed my mind" 🫶

---

want the deeper lore? go read "Pragmatic Modules" in perlmodlib and "strict subs" in strict. that's where the real ones hang out. 📚

---

and that's the tea, bestie — go forth and predeclare responsibly 💜

this lil page came from perl v5.44.0, dated 2026-10-17, and it lives at subs(3perl). mwah. 😘🌸