Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members File Members

EkTemplate.h File Reference

Macros for the control of template instantiation. More...

#include "EkCompiler.h"

Include dependency graph for EkTemplate.h:

This graph shows which files directly or indirectly include this file:

Defines

#define EK_EXTERN_CLASS_TMPL(templ, param)

#define EK_EXTERN_CLASS_TMPL2(templ, p1, p2)

#define EK_IMPL_CLASS_TMPL(templ, param)

#define EK_IMPL_CLASS_TMPL2(templ, p1, p2)

Detailed Description

Macros for the control of template instantiation.

Comments: Gnu g++ (and possibly other compilers) will compile template classes into every source file where they are used. When several such compilation units are linked together the redundant template code increases the size of the resulting system. These macros allow you to control which compilation actually instantiates a template class, and which ones refer to it as an external definition.

Use EK_IMPL_CLASS_TMPL or EK_IMPL_CLASS_TMPL2 where you want the class to be compiled.

Use EK_EXTERN_CLASS_TMPL and EK_EXTERN_CLASS_TMPL2 where you want to declare the use of a template instance (usually in an appropriate header file).

Code may be compiled under g++ and other compilers without using these macros. It will run, but may result in larger than necessary executable files. Failure to use the macros may also prevent the proper inlining of methods (depending on compiler).

These macros may be used with any compiler. They produce null results on compilers where they are not needed.

Define Documentation

#define EK_EXTERN_CLASS_TMPL ( templ,
param )

#define EK_EXTERN_CLASS_TMPL2 ( templ,
p1,
p2 )

#define EK_IMPL_CLASS_TMPL ( templ,
param )

#define EK_IMPL_CLASS_TMPL2 ( templ,
p1,
p2 )