__cdecl 是 C 和 C++ 程式的預設呼叫慣例。 由於堆疊已由呼叫端清除,所以它可以執行 vararg 函式。 呼叫 __cdecl 慣例會建立比 __stdcall 更大的可執行文件,因為它需要每個函式呼叫來包含堆疊清除程序代碼。 下列清單會顯示這個呼叫慣例的實作。
__cdecl 修飾元是 Microsoft 專屬的修飾元。
| 元素 | 實作 |
|---|---|
| 引數傳遞順序 | 由右至左。 |
| 堆疊維護責任 | 呼叫函式會從堆疊取出引數。 |
| 名稱裝飾慣例 | 底線字元 (_) 前面會加上名稱,但導出使用 C 連結的__cdecl函式除外。 |
| 大小寫轉譯慣例 | 未執行大小寫轉譯。 |
注意
如需相關信息,請參閱 裝飾名稱。
將 __cdecl 修飾詞放在變數或函式名稱之前。 因為 C 命名和呼叫慣例是預設值,因此您必須 __cdecl 在 x86 程式代碼中使用的唯一時間是指定 /Gv (vectorcall)、 /Gz (stdcall) 或 /Gr (fastcall) 編譯程式選項。
/Gd 編譯程序選項會__cdecl強制呼叫慣例。
在 ARM 和 x64 處理器上, __cdecl 會接受,但編譯程式通常會忽略。 ARM 和 x64 的慣例會盡可能在暫存器中傳遞引數,並在堆疊上傳遞後續的引數。 在 x64 程式代碼中,使用 __cdecl 來覆寫 /Gv 編譯程式選項,並使用預設的 x64 呼叫慣例。
對於非靜態類別函式,如果函式是以非正規的方式定義,則不需要在非正規定義上指定呼叫慣例修飾詞。 也就是說,對於類別非靜態成員方法而言,宣告時所指定的呼叫慣例是在定義時假設。 如果已指定此類別定義:
struct CMyClass {
void __cdecl mymethod();
};
這個:
void CMyClass::mymethod() { return; }
相當於這個:
void __cdecl CMyClass::mymethod() { return; }
為了與舊版相容,除非指定編譯程式選項 /Za (停用語言延伸模組),否則 cdecl 和 __cdecl 是同義字。
範例
在下列範例中,編譯器收到的指示是針對 system 函式使用 C 命名及呼叫慣例。
// Example of the __cdecl keyword on function
int __cdecl system(const char *);
// Example of the __cdecl keyword on function pointer
typedef BOOL (__cdecl *funcname_ptr)(void * arg1, const char * arg2, DWORD flags, ...);