TASKING VX-toolset for ARM User Guide

Tool OptionsControl program option: --instantiateMenu entry1. Select C/C++ Compiler » Miscellaneous.2. Select an instantiation mode in the Instantiation mode of external template entities box.Command line syntax--instantiate=modeYou can specify the following modes:usedalllocalDefault: --instantiate=usedDescriptionControl instantiation of external template entities. External template entities are external (that is, non-inlineand non-static) template functions and template static data members. The instantiation mode determinesthe template entities for which code should be generated based on the template definition. Normally,when a file is compiled, template entities are instantiated wherever they are used (the linker will discardduplicate definitions). The overall instantiation mode can, however, be changed with this option. You canspecify the following modes:usedalllocalInstantiate those template entities that were used in the compilation.This will includeall static data members for which there are template definitions. This is the default.Instantiate all template entities declared or referenced in the compilation unit. Foreach fully instantiated template class, all of its member functions and static datamembers will be instantiated whether or not they were used. Non-member templatefunctions will be instantiated even if the only reference was a declaration.Similar to --instantiate=used except that the functions are given internal linkage.This is intended to provide a very simple mechanism for those getting started withtemplates. The compiler will instantiate the functions that are used in eachcompilation unit as local functions, and the program will link and run correctly (barringproblems due to multiple copies of local static variables). However, one may endup with many copies of the instantiated functions, so this is not suitable for productionuse.You cannot use --instantiate=local in conjunction with automatic template instantiation.Related informationControl program option --no-auto-instantiation (Disable automatic C++ instantiation)615