6 Basics [basic]

6.4 Scope [basic.scope]

6.4.1 Declarative regions and scopes [basic.scope.declarative]

Every name is introduced in some portion of program text called a declarative region, which is the largest part of the program in which that name is valid, that is, in which that name may be used as an unqualified name to refer to the same entity.

In general, each particular name is valid only within some possibly discontiguous portion of program text called its scope.

To determine the scope of a declaration, it is sometimes convenient to refer to the potential scope of a declaration.

The scope of a declaration is the same as its potential scope unless the potential scope contains another declaration of the same name.

In that case, the potential scope of the declaration in the inner (contained) declarative region is excluded from the scope of the declaration in the outer (containing) declarative region.

[Example

int j = 24;
int main() {
  int i = j, j;
  j = 42;
}

the identifier j is declared twice as a name (and used twice).

The declarative region of the first j includes the entire example.

The potential scope of the first j begins immediately after that j and extends to the end of the program, but its (actual) scope excludes the text between the , and the }.

The declarative region of the second declaration of j (the j immediately before the semicolon) includes all the text between { and }, but its potential scope excludes the declaration of i.

The scope of the second declaration of j is the same as its potential scope.

— end example

]

The names declared by a declaration are introduced into the scope in which the declaration occurs, except that the presence of a friend specifier, certain uses of the elaborated-type-specifier, and using-directives alter this general behavior.

Given a set of declarations in a single declarative region, each of which specifies the same unqualified name,

(4.1)
they shall all refer to the same entity, or all refer to functions and function templates; or
(4.2)
exactly one declaration shall declare a class name or enumeration name that is not a typedef name and the other declarations shall all refer to the same variable, non-static data member, or enumerator, or all refer to functions and function templates; in this case the class name or enumeration name is hidden ([basic.scope.hiding]).
[Note
: A structured binding ([dcl.struct.bind]), namespace name ([basic.namespace]), or class template name ([temp.pre]) must be unique in its declarative region. — end note
]

[Note

These restrictions apply to the declarative region into which a name is introduced, which is not necessarily the same as the region in which the declaration occurs.

In particular, elaborated-type-specifiers and friend declarations may introduce a (possibly not visible) name into an enclosing namespace; these restrictions apply to that region.

Local extern declarations ([basic.link]) may introduce a name into the declarative region where the declaration appears and also introduce a (possibly not visible) name into an enclosing namespace; these restrictions apply to both regions.

— end note

]

For a given declarative region R and a point P outside R, the set of intervening declarative regions between P and R comprises all declarative regions that are or enclose R and do not enclose P.

[Note

The name lookup rules are summarized in [basic.lookup].

— end note

]