How to Instantiate a Templated Function

Last reviewed: July 31, 1997
Article ID: Q131014
2.00 2.10 4.00 WINDOWS NT kbtool kbprg kbcode

The information in this article applies to:

  • The Microsoft C/C++ Compiler (CL.EXE) included with:
  • Microsoft Visual C++ 32-bit Edition, versions 2.0, 2.1, and 4.0

SUMMARY

There is no built-in way to create an explicit instantiation of a templated function. Normally, an instantiation is created when the function is called the first time with a specific type. Subsequent calls to the function with the same type use the same piece of the code generated before. However, if you want to instantiate the function without actually calling it, you must use one of the methods in this article.

MORE INFORMATION

The best method to use with function templates is to place the function definition in a header file, and include that header file in all of the source files.

If this is not an option then try one of these alternatives:

  • In the source file where the function is defined, explicitly reference the function by taking the address of the function.

    -or-

  • In the source file where the function is defined, add a dummy function that makes a call to the templated function. The dummy function itself does not need to be called.

NOTE: With both of these alternative methods, a prototype still needs to be provided for all source files that might call the templated function.

Sample Code

/* Compile options needed: none
*/

/********** Source File One **********/
void func1(void);

template < class T> T SwapTemplate(T Source) {
   return Source;
}

void Dummy(void) {                            // Option One
   char a = 'a', b;
   b = SwapTemplate(a);
}

void main() {
   int (*pfunc)(int) = SwapTemplate;     // Option Two
   func1();
}

/********** Source File Two **********/

template < class T> T SwapTemplate(T Source); // Prototype

void func1(void) {
   int  a = 5, b;
   char c = 'c', d;
   b = SwapTemplate( a );
   d = SwapTemplate( c );
}


Additional reference words: kbinf 9.00 9.0 9.1 9.10 2.00 2.10 4.00
KBCategory: kbtool kbprg kbcode
KBSubcategory: CPPIss
Keywords : CPPIss kbcode kbprg kbtool
Version : 2.00 2.10 4.00
Platform : NT WINDOWS


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: July 31, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.