C++调用约定和名字约定

C++调用约定和名字约定

转自http://www.cppblog.com/mzty/archive/2007/04/20/22349.html

调用约定：
__cdecl __fastcall与 __stdcall，三者都是调用约定(Calling convention)，它决定如下内容：1)函数参数的压栈顺序，2)由调用者仍是被调用者把参数弹出栈，3)以及产生函数修饰名的方法。

一、__stdcall调用约定：函数的参数自右向左经过栈传递，被调用的函数在返回前清理传送参数的内存栈，

二、_cdecl是C和C＋＋程序的缺省调用方式。每个调用它的函数都包含清空堆栈的代码，因此产生的可执行文件大小会比调用_stdcall函数的大。函数采用从右到左的压栈方式。注意：对于可变参数的成员函数，始终使用__cdecl的转换方式。

三、__fastcall调用约定：它是经过寄存器来传送参数的（实际上，它用ECX和EDX传送前两个双字（DWORD）或更小的参数，剩下的参数仍旧自右向左压栈传送，被调用的函数在返回前清理传送参数的内存栈）。

四、thiscall仅仅应用于"C++"成员函数。this指针存放于CX寄存器，参数从右到左压。thiscall不是关键词，所以不能被程序员指定。

五、naked call采用1-4的调用约定时，若是必要的话，进入函数时编译器会产生代码来保存ESI，EDI，EBX，EBP寄存器，退出函数时则产生代码恢复这些 寄存器的内容。naked call不产生这样的代码。naked call不是类型修饰符，故必须和_declspec共同使用。

调用约定能够经过工程设置：Setting...\C/C++ \Code Generation项进行选择，缺省状态为__cdecl。

名字修饰约定：

一、修饰名(Decoration name)："C"或者"C++"函数在内部（编译和连接）经过修饰名识别
二、C编译时函数名修饰约定规则：
__stdcall调用约定在输出函数名前加上一个下划线前缀，后面加上一个"@"符号和其参数的字节数，格式为_functionname@number,例如：function(int a, int b)，其修饰名为：_function@8
__cdecl调用约定仅在输出函数名前加上一个下划线前缀，格式为_functionname。
__fastcall调用约定在输出函数名前加上一个"@"符号，后面也是一个"@"符号和其参数的字节数，格式为@functionname@number。

三、C++编译时函数名修饰约定规则：
__stdcall调用约定：
1)、以"?"标识函数名的开始，后跟函数名；
2)、函数名后面以"@@YG"标识参数表的开始，后跟参数表；
3)、参数表以代号表示：
X--void ，
D--char，
E--unsigned char，
F--short，
H--int，
I--unsigned int，
J--long，
K--unsigned long，
M--float，
N--double，
_N--bool，
PA--表示指针，后面的代号代表指针类型，若是相同类型的指针连续出现，以"0"代替，一个"0"表明一次重复；
4)、参数表的第一项为该函数的返回值类型，其后依次为参数的数据类型,指针标识在其所指数据类型前；
5)、参数表后以"@Z"标识整个名字的结束，若是该函数无参数，则以"Z"标识结束。
其格式为"?functionname@@YG*****@Z"或"?functionname@@YG*XZ"，例如
   int Test1(char *var1,unsigned long)----"?Test1@@YGHPADK@Z"

   void Test2()-----“?Test2@@YGXXZ”

__cdecl调用约定：
规则同上面的_stdcall调用约定，只是参数表的开始标识由上面的"@@YG"变为"@@YA"。
__fastcall调用约定：
规则同上面的_stdcall调用约定，只是参数表的开始标识由上面的"@@YG"变为"@@YI"。
VC++对函数的省缺声明是"__cedcl",将只能被C/C++调用.

注意：
一、_beginthread须要__cdecl的线程函数地址，_beginthreadex和CreateThread须要__stdcall的线程函数地址。

二、通常WIN32的函数都是__stdcall。并且在Windef.h中有以下的定义：
#define CALLBACK __stdcall
#define WINAPI　 __stdcall


C++和C的缺省约定是__cdecl。

三、extern "C" _declspec(dllexport) int __cdecl Add(int a, int b);
    typedef int (__cdecl*FunPointer)(int a, int b);
    修饰符的书写顺序如上。

四、extern "C"的做用：若是Add(int a, int b)是在c语言编译器编译，而在c++文件使用，则须要在c++文件中声明：extern "C" Add(int a, int b)，由于c编译器和c++编译器对函数名的解释不同（c++编译器解释函数名的时候要考虑函数参数，这样是了方便函数重载，而在c语言中不存在函数重 载的问题），使用extern "C"，实质就是告诉c++编译器，该函数是c库里面的函数。若是不使用extern "C"则会出现连接错误。
通常象以下使用：
#ifdef _cplusplus
#define EXTERN_C extern "C"
#else
#define EXTERN_C extern
#endif

#ifdef _cplusplus
extern "C"{
#endif
EXTERN_C int func(int a, int b);
#ifdef _cplusplus
}
#endif

五、MFC提供了一些宏，可使用AFX_EXT_CLASS来代替__declspec(DLLexport)，并修饰类名，从而导出类，AFX_API_EXPORT来修饰函数，AFX_DATA_EXPORT来修饰变量
AFX_CLASS_IMPORT：__declspec(DLLexport)
AFX_API_IMPORT：__declspec(DLLexport)
AFX_DATA_IMPORT：__declspec(DLLexport)
AFX_CLASS_EXPORT：__declspec(DLLexport)
AFX_API_EXPORT：__declspec(DLLexport)
AFX_DATA_EXPORT：__declspec(DLLexport)
AFX_EXT_CLASS：#ifdef _AFXEXT
    AFX_CLASS_EXPORT
         #else
    AFX_CLASS_IMPORT

六、DLLMain负责初始化(Initialization)和结束(Termination)工做，每当一个新 的进程或者该进程的新的线程访问DLL时，或者访问DLL的每个进程或者线程再也不使用DLL或者结束时，都会调用DLLMain。可是，使用 TerminateProcess或TerminateThread结束进程或者线程，不会调用DLLMain。

七、一个DLL在内存中只有一个实例
DLL程序和调用其输出函数的程序的关系：
1)、DLL与进程、线程之间的关系
DLL模块被映射到调用它的进程的虚拟地址空间。
DLL使用的内存从调用进程的虚拟地址空间分配，只能被该进程的线程所访问。
DLL的句柄能够被调用进程使用；调用进程的句柄能够被DLL使用。
DLLDLL能够有本身的数据段，但没有本身的堆栈，使用调用进程的栈，与调用它的应用程序相同的堆栈模式。

2)、关于共享数据段DLL定义的全局变量能够被调用进程访问；DLL能够访问调用进程的全局数据。使用同 一DLL的每个进程都有本身的DLL全局变量实例。若是多个线程并发访问同一变量，则须要使用同步机制；对一个DLL的变量，若是但愿每一个使用DLL的 线程都有本身的值，则应该使用线程局部存储(TLS，Thread Local Strorage)。