cdecl 是 C 语言中的一种调用约定（calling convention），用于指定函数调用时的参数传递和堆栈清理规则。它定义了函数如何接收参数、如何返回值以及调用方和被调用方如何处理堆栈。了解 cdecl 调用约定对调用 C 函数库，尤其是在使用像 wimlib 这样的库时非常重要。

cdecl 是 C 语言中的一种调用约定（calling convention），用于指定函数调用时的参数传递和堆栈清理规则。它定义了函数如何接收参数、如何返回值以及调用方和被调用方如何处理堆栈。了解 cdecl 调用约定对调用 C 函数库，尤其是在使用像 wimlib 这样的库时非常重要。

cdecl 调用约定概述

1. 参数传递：

   • 函数参数从右到左依次推送到堆栈上。
   • 调用函数时，参数是由调用者推送到堆栈上的。

2. 堆栈清理：

   • 调用者负责清理堆栈。这意味着在函数调用后，调用方需要自己清除堆栈上的参数。

3. 返回值：

   • 返回值通过 EAX 寄存器返回（在 x86 架构上）。

4. 函数名称修饰：

   • 函数名在编译时不会被修饰，因此在使用动态链接库（DLL）时，函数名在导出表中通常是未修饰的。

cdecl 示例

假设你有一个使用 cdecl 调用约定的 C 函数，如下所示：

cCopy Code

// example.h
#ifdef __cplusplus
extern "C" {
#endif

int __cdecl add(int a, int b);

#ifdef __cplusplus
}
#endif

在 C 代码中，这个函数定义了如何接收两个整数参数并返回它们的和。

在 C# 中调用 cdecl 函数

如果你在 C# 中使用 P/Invoke（平台调用）来调用 cdecl 函数，你需要明确指定调用约定。可以通过以下方式来做到这一点：

csharpCopy Code

using System;
using System.Runtime.InteropServices;

class Program
{
    // 声明外部函数
    [DllImport("example.dll", CallingConvention = CallingConvention.Cdecl)]
    public static extern int add(int a, int b);

    static void Main()
    {
        // 调用外部函数
        int result = add(5, 3);
        Console.WriteLine("Result: " + result);
    }
}

解释

• CallingConvention.Cdecl：指定使用 cdecl 调用约定。
• [DllImport("example.dll", CallingConvention = CallingConvention.Cdecl)]：声明 DLL 的函数，并指定调用约定。

使用 wimlib API

对于 wimlib 这样的库，你通常需要知道函数的调用约定，以确保正确调用其 API。假设 wimlib 提供了一个 cdecl 调用约定的函数，你应该按照以下步骤在你的程序中进行调用：

1. 查看 wimlib 的文档，确认其 API 的调用约定和函数签名。
2. 在你的代码中声明这些函数，并确保使用正确的调用约定。
3. 链接到 wimlib 的库文件，并在你的程序中正确地调用这些函数。

总结

cdecl 是一种常见的调用约定，它定义了参数如何传递、堆栈如何管理以及函数如何返回值。在编写代码以调用使用 cdecl 调用约定的库时，你需要确保在声明函数时使用正确的调用约定，并根据需要管理堆栈清理。

---