Dominance (C++)


In the C++ programming language, dominance refers to a particular aspect of C++ name lookup in the presence of Inheritance. When the compiler computes the set of declarations to which a particular name might refer, declarations in very-ancestral classes which are "dominated" by declarations in less-ancestral classes are hidden for the purposes of name lookup. In other languages or contexts, the same principle may be referred to as "name masking" or "shadowing".
The algorithm for computing name lookup is described in section 10.2 of the C++11 Standard. The Standard's description does not use the word "dominance", preferring to describe things in terms of declaration sets and hiding. However, the Index contains an entry for "dominance, virtual base class" referring to section 10.2.

Example without diamond inheritance


void f; // at global scope
struct Grandparent ;
struct Parent : public Grandparent ;
struct Child : public Parent ;

In the above example, Child::g contains a reference to the name f. However, the program as a whole contains four declarations of the name f. In order to figure out which f is meant, the compiler computes an overload set containing all the declarations which are not hidden at the point of the call. The declaration of f at global scope is hidden by Grandparent::f, and in turn Grandparent::f is hidden by Parent::f. Thus the only declaration which is considered by overload resolution is Parent::f — and the result in this case is a diagnostic, because the call-site provides two arguments where Parent::f expects only one.
It is often surprising to new C++ programmers that the declaration of Parent::f dominates and hides all of the more-ancestral declarations, regardless of signature; that is, Parent::f dominates and hides the declaration of Grandparent::f even though the two member functions have very different signatures.
It is also important to observe that in C++, name lookup precedes overload resolution. If Parent::f had multiple overloads and f, the compiler would choose between them at overload-resolution time; but during the name-lookup phase we are concerned only with choosing among the three scopes Grandparent::f, Parent::f, and ::f. The fact that Grandparent::f would have been a better overload than f is not part of the compiler's consideration.

Example with diamond inheritance


struct Grandparent ;
struct Mother : public Grandparent ;
struct Father : public Grandparent ;
struct Child : public Mother, Father ;

In the above example, the compiler computes an overload set for f which contains both Mother::f and Father::Grandparent::f. The compiler produces a diagnostic indicating that the program is ill-formed because the name f is ambiguous.

Example with virtual inheritance


struct Grandparent ;
struct Mother : public virtual Grandparent ;
struct Father : public virtual Grandparent ;
struct Child : public Mother, Father ;

In this final example, the name f once again unambiguously refers to Mother::f, because Mother::f hides the f declared in its Grandparent subobject. The Standard calls out this surprising case in an informative note :
Even if Child itself were to inherit virtually from Grandparent, there would be no ambiguity in name lookup. However, if Child were to inherit non-virtually from Grandparent, then the name would again be ambiguated.