函数名修饰和调用规则

“C”或者“C++”函数在内部（编译和链接）通过修饰名识别。修饰名是编译器在编译函数定义或者原型时生成的字符串。有些情况下使用函数的修饰名是必要的，如在模块定义文件里头指定输出“C++”重载函数、构造函数、析构函数，又如在汇编代码里调用“C””或“C ++”函数等。

修饰名由函数名、类名、调用约定、返回类型、参数等共同决定。

调用约定
调用约定(Calling convention)决定以下内容：函数参数的压栈顺序，由调用者还是被调用者把参数弹出栈，以及产生函数修饰名的方法。MFC支持以下调用约定：

_cdecl
按从右至左的顺序压参数入栈，由调用者（#add 即函数外部的另一个函数）把参数弹出栈。

对于“C”函数或者变量，修饰名是在函数名前加下划线。

对于“C++”函数，有所不同。

如函数void test(void)的修饰名是_test；

对于不属于一个类的“C++”全局函数，修饰名是?test@@ZAXXZ。

这是MFC缺省调用约定。由于是调用者负责把参数弹出栈，所以可以给函数定义个数不定的参数，如printf函数。

_stdcall
按从右至左的顺序压参数入栈，由被调用者（#add 即函数本身）把参数弹出栈。

对于“C”函数或者变量，修饰名以下划线为前缀，然后是函数名，然后是符号“@”及参数的字节数，如函数int func(int a, double b)的修饰名是_func@12。

对于“C++”函数，则有所不同。

所有的Win32 API函数都遵循该约定。

_fastcall
头两个DWORD类型或者占更少字节的参数被放入ECX和EDX寄存器，其他剩下的参数按从右到左的顺序压入栈，由被调用者把参数弹出栈。

对于“C”函数或者变量，修饰名以“@”为前缀，然后是函数名，接着是符号“@”及参数的字节数，如函数int func(int a, double b)的修饰名是@func@12。

对于“C++”函数，有所不同。

未来的编译器可能使用不同的寄存器来存放参数。

thiscall
仅仅应用于“C++”成员函数。this指针存放于CX寄存器，参数从右到左压栈。thiscall不是关键词，因此不能被程序员指定。

naked call
采用1-4的调用约定时，如果必要的话，进入函数时编译器会产生代码来保存ESI，EDI，EBX，EBP寄存器，退出函数时则产生代码恢复这些寄存器的内容。naked call不产生这样的代码。

naked call不是类型修饰符，故必须和_declspec共同使用，如下：

__declspec( naked ) int func( formal_parameters )

{

// Function body

}

过时的调用约定
原来的一些调用约定可以不再使用。它们被定义成调用约定_stdcall或者_cdecl。例如：

#define CALLBACK __stdcall

#define WINAPI __stdcall

#define WINAPIV __cdecl

#define APIENTRY WINAPI

#define APIPRIVATE __stdcall

#define PASCAL __stdcall

表7-1显示了一个函数在几种调用约定下的修饰名（表中的“C++”函数指的是“C++”全局函数，不是成员函数），函数原型是void CALLTYPE test(void)，CALLTYPE可以是_cdecl、_fastcall、_stdcall。

表7-1 不同调用约定下的修饰名

调用约定	extern “C”或.C文件	.cpp, .cxx或/TP编译开关
_cdecl	_test	?test@@ZAXXZ
_fastcall	@test@0	?test@@YIXXZ
_stdcall	_test@0	?test@@YGXXZ

C++ 编译器的函数名修饰规则

函数名字修饰（Decorated Name）方式

函数的名字修饰（Decorated Name）就是编译器在编译期间创建的一个字符串，用来指明函数的定义或原型。

LINK程序或其他工具有时需要指定函数的名字修饰来定位函数的正确位置。多数情况下程序员并不需要知道函数的名字修饰，LINK程序或其他工具会自动区分他们。当然，在某些情况下需要指定函数的名字修饰，例如在C++程序中，为了让LINK程序或其他工具能够匹配到正确的函数名字，就必须为重载函数和一些特殊的函数（如构造函数和析构函数）指定名字装饰。另一种需要指定函数的名字修饰的情况是在汇编程序中调用C或C++的函数。如果函数名字，调用约定，返回值类型或函数参数有任何改变，原来的名字修饰就不再有效，必须指定新的名字修饰。

C和C++程序的函数在内部使用不同的名字修饰方式，下面将分别介绍这两种方式。

1. C编译器的函数名修饰规则

对于__stdcall调用约定，编译器和链接器会在输出函数名前加上一个下划线前缀，函数名后面加上一个“@”符号和其参数的字节数，例如_functionname@number；

__cdecl调用约定仅在输出函数名前加上一个下划线前缀，例如_functionname。

__fastcall调用约定在输出函数名前加上一个“@”符号，后面也是一个“@”符号和其参数的字节数，例如@functionname@number

2. C++编译器的函数名修饰规则

C++的函数名修饰规则有些复杂，但是信息更充分，通过分析修饰名不仅能够知道函数的调用方式，返回值类型，参数个数甚至参数类型。

不管__cdecl，__fastcall还是__stdcall调用方式，函数修饰都是：? + 函数的名字 + 参数表的开始标识 + 按照参数类型代号拼出的参数表。

参数表的开始标识：

对于__stdcall方式是“@@YG”，

对于__cdecl方式是“@@YA”，

对于__fastcall方式是“@@YI”。

参数表的拼写代号如下所示：
X--void
D--char
E--unsigned char
F--short
H--int
I--unsigned int
J--long
K--unsigned long（DWORD）
M--float
N--double
_N--bool
U--struct
....
指针的方式有些特别，用PA表示指针，用PB表示const类型的指针，后面的代号表明指针类型，如果相同类型的指针连续出现，以“0”代替，一个“0”代表一次重复。

U表示结构类型，通常后跟结构体的类型名，用“@@”表示结构类型名的结束。

函数的返回值不作特殊处理，它的描述方式和函数参数一样，紧跟着参数表的开始标志，也就是说，函数参数表的第一项表示函数的返回值类型。

参数表后以“@Z”标识整个名字的结束，如果该函数无参数，则以“Z”标识结束。

下面举两个例子，假如有以下函数声明：

int Function1 (char *var1,unsigned long);
其函数修饰名为“?Function1@@YGHPADK@Z”，

而对于函数声明：
void Function2();
其函数修饰名则为“?Function2@@YGXXZ” 。

对于C++的类成员函数（其调用方式是thiscall），函数的名字修饰与非成员的C++函数稍有不同，

首先就是在函数名字和参数表之间插入以“@”字符引导的类名；

其次是参数表的开始标识不同，public成员函数的标识是“@@QAE”；protected成员函数的标识是“@@IAE”；private成员函数的标识是“@@AAE”，

如果函数声明使用了const关键字，则相应的标识应分别为“@@QBE”，“@@IBE”和“@@ABE”。

如果参数类型是类实例的引用，则使用“AAV1”，对于const类型的引用，则使用“ABV1”。

下面就以类CTest为例说明C++成员函数的名字修饰规则：
class CTest
{
......
private:
    void Function(int);
protected:
    void CopyInfo(const CTest &src);
public:
    long DrawText(HDC hdc, long pos, const TCHAR* text, RGBQUAD color, BYTE bUnder, bool bSet);
    long InsightClass(DWORD dwClass) const;
......
};

对于成员函数Function，其函数修饰名为“?Function@CTest@@AAEXH@Z”，字符串“@@AAE”表示这是一个私有函数。

成员函数CopyInfo只有一个参数，是对类CTest的const引用参数，其函数修饰名为“?CopyInfo@CTest@@IAEXABV1@@Z”。（#add 末尾怎么有两个@？）

DrawText是一个比较复杂的函数声明，不仅有字符串参数，还有结构体参数和HDC句柄参数，需要指出的是HDC实际上是一个HDC__结构类型的指针，这个参数的表示就是“PAUHDC__@@”，其完整的函数修饰

补充：软件开发 , C++ ,