vars(3pm)

🌸 vars(3pm) — the Perl Programmers Reference Guide, bestie edition 🌸

Okay so picture this: it's a .pm manual page, the name is vars, and it's literally the Perl pragma that predeclares your global variable names. Welcome to the group chat 💅

---

✨ NAME ✨

vars — the Perl pragma to predeclare global variable names. That's it, that's the whole vibe. 🎀

---

🦋 SYNOPSIS 🦋

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

Look at her go. Iconic. 🔥

---

💖 DESCRIPTION 💖

NOTE, bestie, listen up: 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 — and those have been available since Perl v5.6.0 or later. So like… use of this pragma is discouraged. Not banned, just, y'know, the elders would prefer you didn't. See "our" in perlfunc for the glow-up version. 👑

So what does this thing actually do? It predeclares all the variables whose names are in your list — which means you can use them under use strict without the whole thing screaming at you, and it also disables any typo warnings for them. Basically it's a little "no frills, she's with me" pass for your variable names. 😭✨

Now here's the part where it gets different from the other pragmas, and ngl this is the main character detail: pragmas that affect the $^H hints variable are lexically scoped, right? Not this one. The "use vars" and "use subs" declarations are not lexically scoped to the block they appear in — they affect the entire package in which they appear. And you cannot rescind these declarations with no vars or no subs. Nope. No take-backsies. Once she's in the package, she's in the package. 💀

Then there's the whole loading-shenanigans situation: packages like the AutoLoader and SelfLoader that delay loading of subroutines within packages can create problems with package lexicals defined using my(). Rough, I know. And while the vars pragma cannot duplicate the effect of package lexicals (that's total transparency outside of the package, which, good luck), it can act as an acceptable substitute by pre-declaring global symbols — which ensures they're available to the later-loaded routines. She's not the real thing, but she's showing up and doing the job. 🫶

See "Pragmatic Modules" in perlmodlib if you wanna go deeper. 🌈

---

🧚 sign-off 🧚

Ok that's the whole page, bestie — go predeclare responsibly (or, like, use our instead, she said what she said ✨). This lil doc ships with perl v5.42.3 and is dated 2026-11-03, and yes it's the vars(3pm) page from the Perl Programmers Reference Guide. Mwah 💋🌸