__cdecl
__cdecl to domyślna konwencja wywoływania programów C i C++. Ponieważ stos jest czyszczony przez obiekt wywołujący, może wykonywać vararg funkcje. Konwencja __cdecl wywoływania tworzy większe pliki wykonywalne niż __stdcall, ponieważ wymaga wywołania każdej funkcji w celu uwzględnienia kodu oczyszczania stosu. Na poniższej liście przedstawiono implementację niniejszej konwencji wywoływania. Modyfikator __cdecl jest specyficzny dla firmy Microsoft.
| Element | Implementacja |
|---|---|
| Kolejność przekazywania argumentów | Od prawej do lewej. |
| Odpowiedzialność za utrzymanie stosu | Funkcja wywołująca pobiera argumenty ze stosu. |
| Konwencja dekorowania nazw | Znak podkreślenia (_) jest poprzedzony nazwami, z wyjątkiem sytuacji, gdy funkcje __cdecl używające linku języka C są eksportowane. |
| Konwencja translacji wielkości liter | Translacja wielkości liter nie jest wykonywana. |
Uwaga
Aby uzyskać powiązane informacje, zobacz Nazwy ozdobione.
__cdecl Umieść modyfikator przed zmienną lub nazwą funkcji. Ponieważ konwencje nazewnictwa i wywoływania języka C są domyślne, jedynym czasem, którego należy użyć __cdecl w kodzie x86, jest określenie opcji kompilatora /Gv (vectorcall), /Gz (stdcall) lub /Gr (fastcall). /Gd opcji kompilatora wymusza konwencję __cdecl wywoływania.
W procesorach ARM i x64 jest akceptowany, __cdecl ale zazwyczaj ignorowany przez kompilator. Przez konwencję na ARM i x64, argumenty są przekazywane w rejestrach, jeżeli jest to możliwe, a pozostałe argumenty są przekazywane na stosie. W kodzie x64 użyj polecenia __cdecl , aby zastąpić opcję /Gv kompilatora i użyć domyślnej konwencji wywoływania x64.
W przypadku funkcji niestatycznych klas, jeśli funkcja jest zdefiniowana poza wierszem, modyfikator konwencji wywoływania nie musi być określony w definicji poza wierszem. Oznacza to, że dla metod niestatycznej składowej klasy przyjmowana jest konwencja wywoływania określona podczas deklaracji w punkcie definicji. Biorąc pod uwagę tę definicję klasy:
struct CMyClass {
void __cdecl mymethod();
};
to:
void CMyClass::mymethod() { return; }
jest równoważne temu:
void __cdecl CMyClass::mymethod() { return; }
Aby uzyskać zgodność z poprzednimi wersjami, cdecl i _cdecl są synonimem, __cdecl chyba że określono opcję kompilatora /Za (Wyłącz rozszerzenia języka).
Przykład
W poniższym przykładzie kompilator jest poinstruowany o użyciu konwencji nazewnictwa i wywoływania języka C dla system funkcji.
// 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, ...);
Zobacz też
Przekazywanie argumentów i konwencje nazewnictwa
Słowa kluczowe