This documentation is archived and is not being maintained.

Function Inlining Problems

If you are using function inlining, you must:

  • Have the inline functions implemented in the header file you include.
  • Have inlining turned ON in the header file.

If you are using the #pragma inline_depth compiler directive, make sure you have a value of 2 or greater set. A value of zero will turn off inlining. Also make sure you are using the /Ob1 or /Ob2 compiler options.

Mixing inline and non-inline compile options on different modules can sometimes cause problems. If a C++ library is created with function inlining turned on (/Ob1 or /Ob2) but the corresponding header file describing the functions has inlining turned off (no option), you will get error LNK2001. The functions do not get inlined into the code from the header file, but since they are not in the library file there is no address to resolve the reference.

Similarly, a project that uses function inlining yet defines the functions in a .cpp file rather than in the header file will also get error LNK2001. The header file is included everywhere deemed appropriate, but the functions are only inlined when the .cpp file passes through the compiler; therefore, the linker sees the functions as unresolved externals when used in other modules.

TESTCLS.H

class testcls
{
   public:
      void PublicStatMemFunc1(void);
};

CLASFUNC.CPP

#include "testcls.h"

inline void testcls::PublicStatMemFunc1(void)
{
}

TEST2.CPP

#include "testcls.h"

int main()
{
 testcls testclsObject;
 testclsObject.PublicStatMemFunc1( );   //This needed for compiler to add entry to table of unresolved symbols
                            //Will cause an LNK2001 because this module cannot
 }                         //  see the implementation of PublicStatMemFunc1( );
Show: