delphi的调用约定

Calling conventions（调用约定）

在声明过程或函数时，你可以使用下面的指示字之一来指明调用约定：register、pascal、cdecl、stdcall以及safecall。比如，

function MyFunction(X, Y: Real): Real; cdecl;

...

调用约定决定了参数被传递给例程的顺序，它们也影响从堆栈中删除参数、传递参数时寄存器的使用，以及错误和异常处理。默认的调用约定是register。

• register 和pascal 调用从左到右传递参数，也就是说，最左边的参数最早被计算并传递，最右边的参数最后被计算和传递；cdecl、stdcall 和safecall 调用从右到左传递参数；

• 除了cdecl 调用，过程和函数在返回之前从堆栈中移除参数，而使用cdecl，当调用返回时，调用者从堆栈中移除参数；

• register 调用能使用多达3 个CPU 寄存器传递参数，而其它调用则全部使用堆栈传递参数；

• safecall 调用实现了异常“防火墙”，在Windows 下，它实现了进程间COM 错误通知。

下面的表格对调用约定进行了总结：

--------------------------------------------------------------------------------------------------

-指示字-------------- 参数顺序--------- Clean-up ---------------使用寄存器传递参数？|

-register--------------- Left-to-right ---------Routine -----------------Yes---------------------||

-pascal --------------- Left-to-right ---------Routine -----------------No----------------------|

-cdecl----------------- Right-to-left ---------Caller --------------------No---------------------|

-stdcall ----------------Right-to-left ----------Routine --------------------No------------------|

-safecall--------------- Right-to-left ----------Routine --------------------No------------------|

-------------------------------------------------------------------------------------------------

默认的register 调用是最有效的，因为它通常避免了要创建堆栈结构（stack frame）（访问公布属性的方法必须使用register）；当调用来自C/C++编写的共享库中的函数时，cdecl 是有用的；通常，当调用外部代码时，推荐使用stdcall 和safecall。在Windows 中，系统API 使用stdcall 和safecall，其它操作系统通常使用cdecl（注意，stdcall 比cdecl 更有效）。

声明双重接口的方法必须使用safecall；保留pascal 调用是为了向后兼容性。要了解更多的调用约定的信息，请参考Program control。

指示字near、far 和export 用在16 位Windows 编程中，它们对32 位程序没有影响，保留它们是为了向后兼容性。