Sealing Classes in C++

Published November 19, 2007 by Francis Xavier, posted by Myopic Rhino
Do you see issues with this article? Let us know.
Advertisement

Introduction

Some recent languages like C# and Java allow you to seal your classes easily using a keyword like sealed or final respectively. C++ doesn't have any such keyword for this purpose. However, it's possible to still do it using a trick: When using virtual inheritance, the initialization list of the most-derived-class's constructor directly invokes the virtual base class's constructor. This means that if we can hide access to the virtual base class's constructor, then we can prevent any class from deriving from it. This mimics the effect of being sealed.

Solution Attempt #1

To provide an easy way to seal classes, we can write a header file Sealed.h like this:


class SealedBase
{
protected:
    SealedBase()
    {
    }
};

#define Sealed private virtual SealedBase
Now to seal a class, say Penguin, we just need to derive it from Sealed, like this:

#include "Sealed.h"

class Penguin : Sealed
{
};
That's it. Penguin is now a sealed class. Let's try deriving another class, BigZ (Surf's Up (2007), anyone?) from Penguin:

class BigZ : Penguin
{
};

BigZ bigZ; // error C2248
Instantiating an object of BigZ should yield a compiler error. The MSVC++ 2005 compiler gives me the following error message:

error C2248: 'SealedBase::SealedBase' : cannot access inaccessible member declared in class 'SealedBase'

A Serious Flaw

All seems to be working well. However, one of my fellow programmers, Angelo Rohit, pointed out to me that this method has a serious flaw in it. Angelo says that if BigZ derives from Penguin and Sealed, then it will be possible to create objects of BigZ:


class BigZ : Penguin, Sealed
{
};

BigZ bigZ; // OK; no compiler error
Why does this happen? BigZ derives from Sealed just like Penguin does, which means that it now has access to Sealed's constructor. And since Sealed is inherited virtually by both Penguin and BigZ, there is only one copy of it - which is now also accessible to BigZ. Bummer. We need to have a mechanism by which BigZ is forced to call the constructor of a class which it doesn't have access to.

Solution Attempt #2

After pondering over this for a while, I realized that if we can somehow generate different base classes every time Sealed is derived from, then it would work. Let's rewrite the Sealed.h header to look like this:


template < int T >
class SealedBase
{
protected:
    SealedBase()
    {
    }
};

#define Sealed private virtual SealedBase<__COUNTER__>
What does this do? SealedBase is now a templated class which takes an integer as an argument. __COUNTER__ is a predefined macro which expands to an integer starting with 0 and incrementing by 1 every time it is used in a compiland. So every time Sealed is derived from, it generates a new SealedBase class using the incremental number which __COUNTER__ expands to.

Now let's go back to our BigZ class which derives from both Penguin and Sealed:


class BigZ : Penguin, Sealed
{
};

BigZ bigZ; // error C2248
This time around though, BigZ can't escape from the compiler. Penguin derives from SealedBase and BigZ derives from SealedBase, where number1 and number2 are two non-identical integers. So now BigZ has to invoke the constructor of SealedBase, which it doesn't have access to.

The MSVC++ 2005 compiler gives me the following error message:


error C2248: 'SealedBase::SealedBase' : cannot access inaccessible member declared in class 'SealedBase'
1> with
1> [
1> T=0
1> ]

Portability Issues

However, you might be thinking that since we're using a special predefined macro __COUNTER__ in our implementation, this code is not portable. Well, it's supported by MSVC++ (which I used to test the above code) and also by GCC. But what about compilers which don't?

A Portable Solution

After a little thought, I came up with the following way:

In Sealed.h:


template < class T >
class SealedBase
{
protected:
    SealedBase()
    {
    }
};

#define Sealed(_CLASS_NAME_) private virtual SealedBase<_CLASS_NAME_>
And to seal a class:

#include "Sealed.h"

class Penguin : Sealed(Penguin)
{
};
When sealing a class, we need to mention that class's name to the Sealed macro. This enables the Sealed macro to generate a new version of SealedBase. This is less elegant than simply having to derive from Sealed, but is more portable, making it a good alternative for compilers which don't support the __COUNTER__ predefined macro.

Final Words

People who use MSVC++ or GCC can simply use Solution Attempt #2, as it is cleaner. People on other compilers, can use the Portable Solution. If you have any questions, suggestions, improvements, or simply want to say hi, please email me at francisxavierjp [at] gmail [dot] com.

Thanks for Reading!
Francis Xavier

References

[1] C++ Q&A: List View Mode, SetForegroundWindow, and Class Protection
[2] Vladislav Lazarenko: "[boost] Sealed C++ class."

Cancel Save
0 Likes 0 Comments

Comments

Nobody has left a comment. You can be the first!
You must log in to join the conversation.
Don't have a GameDev.net account? Sign up!
Advertisement