vars(3perl)

✨ vars(3perl) ✨

okay bestie, settling in? because this is the vars page from the Perl Programmers Reference Guide and it's giving vintage-but-still-here 💅

---

🌸 NAME 🌸

vars — the Perl pragma that predeclares your global variable names for you, so you don't have to fight with strict about it 💖

---

🦋 SYNOPSIS 🦋

use vars qw($frob @mung %seen);

that's it. that's the whole vibe. three little sigils, one happy package 🎀

---

💜 DESCRIPTION 💜

okay so first things first, and I need you to actually listen to me on this one because it's important:

NOTE: if you're using variables in the current package for a single scope, the functionality this pragma gives you has been superseded by "our" declarations — those have been around since Perl v5.6.0 or later. and honestly? use of this pragma is discouraged. discouraged bestie!! go look at "our" in perlfunc instead. 🙈

cool cool cool. now for the people still here (no judgement, legacy code is a lifestyle):

this pragma will predeclare every single variable whose name is in that list you passed it. what does that get you? two (2) iconic gifts:

• you can use those variables under use strict without it screaming at you 😌
• it disables any typo warnings for them ✨

---

🧚 the scoping thing (pay attention, this is the weird part)

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. not block scoped!! they affect the entire package in which they appear. the whole thing. all of it. 👑

and because the universe loves chaos: it is not possible to rescind these declarations with "no vars" or "no subs". nope. once they're declared, they're declared. it's giving permanent marker energy 💀

---

🍓 why does this exist (the AutoLoader/SelfLoader situation)

so here's the lore: packages like the AutoLoader and SelfLoader — the ones that delay loading of subroutines within packages — can create problems with package lexicals defined using my(). messy. tragic. we've all been there.

now, the vars pragma cannot duplicate the effect of package lexicals — like, it can't give you that total transparency outside of the package — but it can act as an acceptable substitute by pre-declaring global symbols, which means ensuring their availability to the later-loaded routines. so your late-arriving subs still know who everyone is 🫶

---

🌈 SEE ALSO 🌈

• "Pragmatic Modules" in perlmodlib

---

and that's the whole page, bestie!! ⭐

this was perl v5.44.0, dated 2026-10-17, and it lives under the name vars(3perl) in the Perl Programmers Reference Guide 🎀💖 go forth and maybe use our instead, ily ✨