This module implements lexical scoping of static variables and subroutines. Although it can be used directly, it is mainly intended to be infrastructure for modules that manage namespaces.

This module influences the meaning of single-part variable names that appear directly in code, such as "'$foo'". Normally, in the absence of any particular declaration, or under the effect of an 'our' declaration, this would refer to the scalar variable of that name located in the current package. A 'Lexical::Var' declaration can change this to refer to any particular scalar, bypassing the package system entirely. A variable name that includes an explicit package part, such as "'$main::foo'", always refers to the variable in the specified package, and is unaffected by this module. A symbolic reference through a string value, such as "'${'foo'}'", also looks in the package system, and so is unaffected by this module.