Microsoft KB Archive/126845

= Description of C++ name decoration =

Article ID: 126845

Article Last Modified on 9/1/2005

-

APPLIES TO


 * Microsoft Visual C++ 1.5 Professional Edition
 * Microsoft Visual C++ 1.51
 * Microsoft Visual C++ 1.52 Professional Edition
 * Microsoft Visual C++ 2.0 Professional Edition
 * Microsoft Visual C++ 2.1
 * Microsoft Visual C++ 4.0 Standard Edition
 * Microsoft Visual C++ 4.1 Subscription
 * Microsoft Visual C++ 5.0 Enterprise Edition
 * Microsoft Visual C++ 6.0 Enterprise Edition
 * Microsoft Visual C++ 5.0 Professional Edition
 * Microsoft Visual C++ 6.0 Professional Edition
 * Microsoft Visual C++ 6.0 Standard Edition

-



This article was previously published under Q126845



SUMMARY
The Microsoft C++ compilers encode the names of symbols in C++ programs to include type information in the name. This is called "name decoration," or "name mangling." The purpose of this is to ensure type-safe linking. The C++ language allows function overloading where functions with the same name are only distinguished from one another by the data types of the arguments to the functions. Name decoration enables the linker to distinguish between different versions of overloaded functions because the names of the functions are encoded or decorated differently.



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:

132044 Using _declspec(dllimport) and _declspec(dllexport) in code

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:

http://www.microsoft.com/downloads/details.aspx?FamilyID=621ae185-1c2a-4d6b-8146-183d66fe709d&displaylang=en

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   #include 

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 #include #include   #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; }

Keywords: kbinfo kbcpponly kbcode kbcompiler KB126845

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.