______________________________________________________________________
10 Derived classes [class.derived]
______________________________________________________________________
1 A list of base classes can be specified in a class definition using
the notation:
base-clause:
: base-specifier-list
base-specifier-list:
base-specifier
base-specifier-list , base-specifier
base-specifier:
::opt nested-name-specifieropt class-name
virtual access-specifieropt ::opt nested-name-specifieropt class-name
access-specifier virtualopt ::opt nested-name-specifieropt class-name
access-specifier:
private
protected
public
The class-name in a base-specifier shall not be an incompletely
defined class (clause _class_); this class is called a direct base
class for the class being declared. During the lookup for a base
class name, non-type names are ignored (_basic.scope.hiding_). If the
name found is not a class-name, the program is ill-formed. A class B
is a base class of a class D if it is a direct base class of D or a
direct base class of one of D's base classes. A class is an indirect
base class of another if it is a base class but not a direct base
class. A class is said to be (directly or indirectly) derived from
its (direct or indirect) base classes. [Note: See clause
_class.access_ for the meaning of access-specifier. ] Unless rede-
fined in the derived class, members of a base class are also consid-
ered to be members of the derived class. The base class members are
said to be inherited by the derived class. Inherited members can be
referred to in expressions in the same manner as other members of the
derived class, unless their names are hidden or ambiguous (_class.mem-
ber.lookup_). [Note: the scope resolution operator :: (_expr.prim_)
can be used to refer to a direct or indirect base member explicitly.
This allows access to a name that has been redefined in the derived
class. A derived class can itself serve as a base class subject to
access control; see _class.access.base_. A pointer to a derived class
can be implicitly converted to a pointer to an accessible unambiguous
base class (_conv.ptr_). An lvalue of a derived class type can be
bound to a reference to an accessible unambiguous base class
(_dcl.init.ref_). ]
2 The base-specifier-list specifies the type of the base class subob-
jects contained in an object of the derived class type. [Example:
class Base {
public:
int a, b, c;
};
class Derived : public Base {
public:
int b;
};
class Derived2 : public Derived {
public:
int c;
};
Here, an object of class Derived2 will have a sub-object of class
Derived which in turn will have a sub-object of class Base. ]
3 The order in which the base class subobjects are allocated in the most
derived object (_intro.object_) is unspecified. [Note: a derived
class and its base class sub-objects can be represented by a directed
acyclic graph (DAG) where an arrow means "directly derived from." A
DAG of sub-objects is often referred to as a "sub-object lattice."
Base
|
|
Derived
|
Derived2
The arrows need not have a physical representation in memory. ]
4 [Note: initialization of objects representing base classes can be
specified in constructors; see _class.base.init_. ]
5 [Note: A base class subobject might have a layout (_basic.stc_) dif-
ferent from the layout of a most derived object of the same type. A
base class subobject might have a polymorphic behavior (_class.cdtor_)
different from the polymorphic behavior of a most derived object of
the same type. A base class subobject may be of zero size (clause
_class_); however, two subobjects that have the same class type and
that belong to the same most derived object must not be allocated at
the same address (_expr.eq_). ]
10.1 Multiple base classes [class.mi]
1 A class can be derived from any number of base classes. [Note: the
use of more than one direct base class is often called multiple inher-
itance. ] [Example:
class A { /* ... */ };
class B { /* ... */ };
class C { /* ... */ };
class D : public A, public B, public C { /* ... */ };
--end example]
2 [Note: the order of derivation is not significant except as specified
by the semantics of initialization by constructor (_class.base.init_),
cleanup (_class.dtor_), and storage layout (_class.mem_,
_class.access.spec_). ]
3 A class shall not be specified as a direct base class of a derived
class more than once. [Note: a class can be an indirect base class
more than once and can be a direct and an indirect base class. There
are limited things that can be done with such a class. The non-static
data members and member functions of the direct base class cannot be
referred to in the scope of the derived class. However, the static
members, enumerations and types can be unambiguously referred to. ]
[Example:
class X { /* ... */ };
class Y : public X, public X { /* ... */ }; // ill-formed
class L { public: int next; /* ... */ };
class A : public L { /* ... */ };
class B : public L { /* ... */ };
class C : public A, public B { void f(); /* ... */ }; // well-formed
class D : public A, public L { void f(); /* ... */ }; // well-formed
--end example]
4 A base class specifier that does not contain the keyword virtual,
specifies a nonvirtual base class. A base class specifier that con-
tains the keyword virtual, specifies a virtual base class. For each
distinct occurrence of a nonvirtual base class in the class lattice of
the most derived class, the most derived object (_intro.object_) shall
contain a corresponding distinct base class subobject of that type.
For each distinct base class that is specified virtual, the most
derived object shall contain a single base class subobject of that
type. [Example: for an object of class type C, each distinct occur-
rence of a (non-virtual) base class L in the class lattice of C corre-
sponds one-to-one with a distinct L subobject within the object of
type C. Given the class C defined above, an object of class C will
have two sub-objects of class L as shown below.
L L
| |
| |
A B
C
In such lattices, explicit qualification can be used to specify which
subobject is meant. The body of function C::f could refer to the mem-
ber next of each L subobject:
void C::f() { A::next = B::next; } // well-formed
Without the A:: or B:: qualifiers, the definition of C::f above would
be ill-formed because of ambiguity (_class.member.lookup_).
5 For another example,
class V { /* ... */ };
class A : virtual public V { /* ... */ };
class B : virtual public V { /* ... */ };
class C : public A, public B { /* ... */ };
for an object c of class type C, a single subobject of type V is
shared by every base subobject of c that is declared to have a virtual
base class of type V. Given the class C defined above, an object of
class C will have one subobject of class V, as shown below.
V
A B
C
6 A class can have both virtual and nonvirtual base classes of a given
type.
class B { /* ... */ };
class X : virtual public B { /* ... */ };
class Y : virtual public B { /* ... */ };
class Z : public B { /* ... */ };
class AA : public X, public Y, public Z { /* ... */ };
For an object of class AA, all virtual occurrences of base class B in
the class lattice of AA correspond to a single B subobject within the
object of type AA, and every other occurrence of a (non-virtual) base
class B in the class lattice of AA corresponds one-to-one with a dis-
tinct B subobject within the object of type AA. Given the class AA
defined above, class AA has two sub-objects of class B: Z's B and the
virtual B shared by X and Y, as shown below.
B B
|
|
X Y Z
AA
--end example]
10.2 Member name lookup [class.member.lookup]
1 Member name lookup determines the meaning of a name id-expression) in
a class scope (_basic.scope.class_). Name lookup can result in an
ambiguity, in which case the program is ill-formed. For an id-expres-
sion, name lookup begins in the class scope of this; for a qualified-
id, name lookup begins in the scope of the nested-name-specifier.
Name lookup takes place before access control (_basic.lookup_, clause
_class.access_).
2 The following steps define the result of name lookup in a class scope,
C. First, every declaration for the name in the class and in each of
its base class sub-objects is considered. A member name f in one sub-
object B hides a member name f in a sub-object A if A is a base class
sub-object of B. Any declarations that are so hidden are eliminated
from consideration. Each of these declarations that was introduced by
a using-declaration is considered to be from each sub-object of C that
is of the type containing the declaration designated by the
using-declaration.1) If the resulting set of declarations are not all
_________________________
1) Note that using-declarations cannot be used to resolve inherited
from sub-objects of the same type, or the set has a nonstatic member
and includes members from distinct sub-objects, there is an ambiguity
and the program is ill-formed. Otherwise that set is the result of
the lookup.
3 [Example:
class A {
public:
int a;
int (*b)();
int f();
int f(int);
int g();
};
class B {
int a;
int b();
public:
int f();
int g;
int h();
int h(int);
};
class C : public A, public B {};
void g(C* pc)
{
pc->a = 1; // error: ambiguous: A::a or B::a
pc->b(); // error: ambiguous: A::b or B::b
pc->f(); // error: ambiguous: A::f or B::f
pc->f(1); // error: ambiguous: A::f or B::f
pc->g(); // error: ambiguous: A::g or B::g
pc->g = 1; // error: ambiguous: A::g or B::g
pc->h(); // OK
pc->h(1); // OK
}
--end example] [Example:
struct U { static int i; };
struct V : U { };
struct W : U { using U::i; };
struct X : V, W { void foo(); };
void X::foo() {
i; // finds U::i in two ways: as W::i and U::i in V
// no ambiguity because U::i is static
}
--end example]
4 If the name of an overloaded function is unambiguously found, over-
loading resolution (_over.match_) also takes place before access con-
trol. Ambiguities can often be resolved by qualifying a name with its
class name. [Example:
_________________________
member ambiguities; see _namespace.udecl_.
class A {
public:
int f();
};
class B {
public:
int f();
};
class C : public A, public B {
int f() { return A::f() + B::f(); }
};
--end example]
5 A static member, a nested type or an enumerator defined in a base
class T can unambiguously be found even if an object has more than one
base class subobject of type T. Two base class subobjects share the
nonstatic member subobjects of their common virtual base classes.
[Example:
class V { public: int v; };
class A {
public:
int a;
static int s;
enum { e };
};
class B : public A, public virtual V {};
class C : public A, public virtual V {};
class D : public B, public C { };
void f(D* pd)
{
pd->v++; // OK: only one v (virtual)
pd->s++; // OK: only one s (static)
int i = pd->e; // OK: only one e (enumerator)
pd->a++; // error, ambiguous: two as in D
}
--end example]
6 When virtual base classes are used, a hidden declaration can be
reached along a path through the sub-object lattice that does not pass
through the hiding declaration. This is not an ambiguity. The iden-
tical use with nonvirtual base classes is an ambiguity; in that case
there is no unique instance of the name that hides all the others.
[Example:
class V { public: int f(); int x; };
class W { public: int g(); int y; };
class B : public virtual V, public W
{
public:
int f(); int x;
int g(); int y;
};
class C : public virtual V, public W { };
class D : public B, public C { void glorp(); };
W V W
B C
D
The names defined in V and the left hand instance of W are hidden by
those in B, but the names defined in the right hand instance of W are
not hidden at all.
void D::glorp()
{
x++; // OK: B::x hides V::x
f(); // OK: B::f() hides V::f()
y++; // error: B::y and C's W::y
g(); // error: B::g() and C's W::g()
}
--end example]
7 An explicit or implicit conversion from a pointer to or an lvalue of a
derived class to a pointer or reference to one of its base classes
shall unambiguously refer to a unique object representing the base
class. [Example:
class V { };
class A { };
class B : public A, public virtual V { };
class C : public A, public virtual V { };
class D : public B, public C { };
void g()
{
D d;
B* pb = &d;
A* pa = &d; // error, ambiguous: C's A or B's A?
V* pv = &d; // OK: only one V sub-object
}
--end example]
10.3 Virtual functions [class.virtual]
1 Virtual functions support dynamic binding and object-oriented program-
ming. A class that declares or inherits a virtual function is called
a polymorphic class.
2 If a virtual member function vf is declared in a class Base and in a
class Derived, derived directly or indirectly from Base, a member
function vf with the same name and same parameter list as Base::vf is
declared, then Derived::vf is also virtual (whether or not it is so
declared) and it overrides2) Base::vf. For convenience we say that
_________________________
2) A function with the same name but a different parameter list
(clause _over_) as a virtual function is not necessarily virtual and
does not override. The use of the virtual specifier in the declara-
tion of an overriding function is legal but redundant (has empty se-
mantics). Access control (clause _class.access_) is not considered in
any virtual function overrides itself. Then in any well-formed class,
for each virtual function declared in that class or any of its direct
or indirect base classes there is a unique final overrider that over-
rides that function and every other overrider of that function. The
rules for member lookup (_class.member.lookup_) are used to determine
the final overrider for a virtual function in the scope of a derived
class but ignoring names introduced by using-declarations. [Example:
struct A {
virtual void f();
};
struct B : virtual A {
virtual void f();
};
struct C : B , virtual A {
using A::f;
};
void foo() {
C c;
c.f(); // calls B::f, the final overrider
c.C::f(); // calls A::f because of the using-declaration
}
--end example]
3 [Note: a virtual member function does not have to be visible to be
overridden, for example,
struct B {
virtual void f();
};
struct D : B {
void f(int);
};
struct D2 : D {
void f();
};
the function f(int) in class D hides the virtual function f() in its
base class B; D::f(int) is not a virtual function. However, f()
declared in class D2 has the same name and the same parameter list as
B::f(), and therefore is a virtual function that overrides the func-
tion B::f() even though B::f() is not visible in class D2. ]
4 Even though destructors are not inherited, a destructor in a derived
class overrides a base class destructor declared virtual; see
_class.dtor_ and _class.free_.
5 The return type of an overriding function shall be either identical to
the return type of the overridden function or covariant with the
classes of the functions. If a function D::f overrides a function
B::f, the return types of the functions are covariant if they satisfy
the following criteria:
--both are pointers to classes or references to classes3)
_________________________
determining overriding.
3) Multi-level pointers to classes or references to multi-level point-
--the class in the return type of B::f is the same class as the class
in the return type of D::f or, is an unambiguous direct or indirect
base class of the class in the return type of D::f and is accessible
in D
--both pointers or references have the same cv-qualification and the
class type in the return type of D::f has the same cv-qualification
as or less cv-qualification than the class type in the return type
of B::f.
If the return type of D::f differs from the return type of B::f, the
class type in the return type of D::f shall be complete at the point
of declaration of D::f or shall be the class type D. When the over-
riding function is called as the final overrider of the overridden
function, its result is converted to the type returned by the (stati-
cally chosen) overridden function (_expr.call_). [Example:
class B {};
class D : private B { friend class Derived; };
struct Base {
virtual void vf1();
virtual void vf2();
virtual void vf3();
virtual B* vf4();
virtual B* vf5();
void f();
};
struct No_good : public Base {
D* vf4(); // error: B (base class of D) inaccessible
};
class A;
struct Derived : public Base {
void vf1(); // virtual and overrides Base::vf1()
void vf2(int); // not virtual, hides Base::vf2()
char vf3(); // error: invalid difference in return type only
D* vf4(); // OK: returns pointer to derived class
A* vf5(); // error: returns pointer to incomplete class
void f();
};
_________________________
ers to classes are not allowed.
void g()
{
Derived d;
Base* bp = &d; // standard conversion:
// Derived* to Base*
bp->vf1(); // calls Derived::vf1()
bp->vf2(); // calls Base::vf2()
bp->f(); // calls Base::f() (not virtual)
B* p = bp->vf4(); // calls Derived::pf() and converts the
// result to B*
Derived* dp = &d;
D* q = dp->vf4(); // calls Derived::pf() and does not
// convert the result to B*
dp->vf2(); // ill-formed: argument mismatch
}
--end example]
6 [Note: the interpretation of the call of a virtual function depends on
the type of the object for which it is called (the dynamic type),
whereas the interpretation of a call of a nonvirtual member function
depends only on the type of the pointer or reference denoting that
object (the static type) (_expr.call_). ]
7 [Note: the virtual specifier implies membership, so a virtual function
cannot be a nonmember (_dcl.fct.spec_) function. Nor can a virtual
function be a static member, since a virtual function call relies on a
specific object for determining which function to invoke. A virtual
function declared in one class can be declared a friend in another
class. ]
8 A virtual function declared in a class shall be defined, or declared
pure (_class.abstract_) in that class, or both; but no diagnostic is
required (_basic.def.odr_).
9 [Example: here are some uses of virtual functions with multiple base
classes:
struct A {
virtual void f();
};
struct B1 : A { // note non-virtual derivation
void f();
};
struct B2 : A {
void f();
};
struct D : B1, B2 { // D has two separate A sub-objects
};
void foo()
{
D d;
// A* ap = &d; // would be ill-formed: ambiguous
B1* b1p = &d;
A* ap = b1p;
D* dp = &d;
ap->f(); // calls D::B1::f
dp->f(); // ill-formed: ambiguous
}
In class D above there are two occurrences of class A and hence two
occurrences of the virtual member function A::f. The final overrider
of B1::A::f is B1::f and the final overrider of B2::A::f is B2::f.
10The following example shows a function that does not have a unique
final overrider:
struct A {
virtual void f();
};
struct VB1 : virtual A { // note virtual derivation
void f();
};
struct VB2 : virtual A {
void f();
};
struct Error : VB1, VB2 { // ill-formed
};
struct Okay : VB1, VB2 {
void f();
};
Both VB1::f and VB2::f override A::f but there is no overrider of both
of them in class Error. This example is therefore ill-formed. Class
Okay is well formed, however, because Okay::f is a final overrider.
11The following example uses the well-formed classes from above.
struct VB1a : virtual A { // does not declare f
};
struct Da : VB1a, VB2 {
};
void foe()
{
VB1a* vb1ap = new Da;
vb1ap->f(); // calls VB2::f
}
--end example]
12Explicit qualification with the scope operator (_expr.prim_) sup-
presses the virtual call mechanism. [Example:
class B { public: virtual void f(); };
class D : public B { public: void f(); };
void D::f() { /* ... */ B::f(); }
Here, the function call in D::f really does call B::f and not D::f. ]
10.4 Abstract classes [class.abstract]
1 The abstract class mechanism supports the notion of a general concept,
such as a shape, of which only more concrete variants, such as circle
and square, can actually be used. An abstract class can also be used
to define an interface for which derived classes provide a variety of
implementations.
2 An abstract class is a class that can be used only as a base class of
some other class; no objects of an abstract class can be created
except as sub-objects of a class derived from it. A class is abstract
if it has at least one pure virtual function. [Note: such a function
might be inherited: see below. ] A virtual function is specified pure
by using a pure-specifier (_class.mem_) in the function declaration in
the class declaration. A pure virtual function need be defined only
if explicitly called with the qualified-id syntax (_expr.prim_).
[Example:
class point { /* ... */ };
class shape { // abstract class
point center;
// ...
public:
point where() { return center; }
void move(point p) { center=p; draw(); }
virtual void rotate(int) = 0; // pure virtual
virtual void draw() = 0; // pure virtual
// ...
};
--end example] [Note: a function declaration cannot provide both a
pure-specifier and a definition --end note] [Example:
struct C {
virtual void f() { }=0; // ill-formed
};
--end example]
3 An abstract class shall not be used as a parameter type, as a function
return type, or as the type of an explicit conversion. Pointers and
references to an abstract class can be declared. [Example:
shape x; // error: object of abstract class
shape* p; // OK
shape f(); // error
void g(shape); // error
shape& h(shape&); // OK
--end example]
4 A class is abstract if it contains or inherits at least one pure vir-
tual function for which the final overrider is pure virtual. [Exam-
ple:
class ab_circle : public shape {
int radius;
public:
void rotate(int) {}
// ab_circle::draw() is a pure virtual
};
Since shape::draw() is a pure virtual function ab_circle::draw() is a
pure virtual by default. The alternative declaration,
class circle : public shape {
int radius;
public:
void rotate(int) {}
void draw(); // a definition is required somewhere
};
would make class circle nonabstract and a definition of circle::draw()
must be provided. ]
5 [Note: an abstract class can be derived from a class that is not
abstract, and a pure virtual function may override a virtual function
which is not pure. ]
6 Member functions can be called from a constructor (or destructor) of
an abstract class; the effect of making a virtual call (_class.vir-
tual_) to a pure virtual function directly or indirectly for the
object being created (or destroyed) from such a constructor (or
destructor) is undefined.