Description of C++ name decoration (126845)

MORE INFORMATION

Different compiler vendors have their own methods or algorithms for decorating names. Microsoft does not publish the algorithm its compilers use for name decoration because it may change in the future. However, it is sometimes necessary to get the decorated version of a function name. For example, you may need to export a C++ function from a Windows DLL by listing it in the EXPORTS section of a .DEF file used to build the DLL. (Although declaring the function with __declspec( dllexport ) is the preferred method to export a C++ function using Visual C++, 32-bit Edition, it is still valid to use a .DEF file with these products.) To export the function successfully, you need to list its decorated name, not the name in the source code.

For all of the products listed above, Microsoft makes Browser Toolkits available. These toolkits provide functions that can interpret decorated names.

For more information about __declspec(dllexport), click the following article number to view the article in the Microsoft Knowledge Base: The following sample code uses the FormatDName function in the browser library, part of the Browser Toolkit. To download the Browser Toolkit, visit the following Microsoft Web site:The function returns the undecorated form of the name passed to it.

Sample code

   /* Compile options needed: cl /AL getname.cpp bthunkl.obj /link bsc.lib
          (for 16-bit, where getname.cpp is the source file name)
                              cl getname.cpp /link bsc.lib
          (for 32-bit version 4.x and earlier, where getname.cpp is the source
           file name)
   */ 

   #include <iostream.h>
   #include <strstrea.h>

   extern "C"
   {
   #include "hungary.h"
   #include "bsc.h"
   #include "bscsup.h"
   }

   void main( int argc, char *argv[] )
   {
       if ( argc < 2 )
       {
           cout << "Usage: GETNAME decorated-name" << endl;
           return;
       }

       strstream name;

       // Call browser library function to get undecorated name
       name << FormatDname ( argv[1] ) << '\0';

       cout << "Undecorated name: " << name.str() << endl;
       name.rdbuf()->freeze( 0 );
   }
				

The following example works with the newer Browser Toolkit 5.0 and Visual C++ version 5.0.

   /* Compile options needed: cl /GX getname.cpp /link msbsc50.lib
          (where getname.cpp is the source file name)
   */ 

   #include <iostream>
   #include <strstream>
   #include <windows.h>
   #include "bsc.h"

   using namespace std;

   int main( int argc, char *argv[] )
   {
       Bsc* pbsc;

       if ( argc < 3 )
       {
           cout << "Usage: GETNAME bscfile-name decorated-name" << endl;
           return 1;
       }

       strstream name;

       // Open the browser file
       Bsc::open( argv[1], &pbsc );

       // Call browser library function to get undecorated name
       name << pbsc->formatDname( argv[2] ) << '\0';

       cout << "Undecorated name: " << name.str() << endl;
       name.rdbuf()->freeze( 0 );

       pbsc->close();
       return 0;
   }