What is the meaning of clang’s -Wweak-vtables?

If all of a class’s virtual methods are inline, the compiler has no way to select a translation unit in which to place a single shared copy of the vtable — instead, a copy of the vtable has to be placed in each object file that needs it. On many platforms the linker is able to unify these multiple copies, either by discarding duplicate definitions or by mapping all references to one copy, so this is only a warning.

Implementing a virtual function out-of-line enables the compiler to select the translation unit that implements that out-of-line method as a “home” for the class’s implementation details, and places the single shared copy of the vtable in the same translation unit. If multiple methods are out-of-line, an arbitrary choice of method may be made by the compiler so long as that choice is determined only by the class’s declaration; for example, GCC chooses the first non-inline method in declaration order.

If you don’t override any method of a class, the virtual keyword has no observable effect, so there’s no need for the compiler to emit a vtable for the class. If you do not derive from A, or if you fail to declare a derived class’s destructor virtual, there are no overridden methods in A and thus A‘s vtable is omitted. If you declare an additional out-of-line virtual method to suppress the warning and also do something that overrides a method in A, the implementation of the non-inline virtual (and its accompanying copy of the vtable) needs to be supplied in a linked translation unit, otherwise linking will fail because the vtable is missing.

Leave a Comment