如何在 Vala 中使用 CCode 属性？

Posted 2023-04-14

【中文标题】如何在 Vala 中使用 CCode 属性？

【英文标题】：How do I use CCode attributes in Vala?

【发布时间】：2012-04-27 20:06:44

【问题描述】：

我正在尝试使用 Vala 的 C 宏。在我看来，这应该可以通过 CCode 指令实现，但我找不到任何关于如何使用它的有意义的文档。

"The Hacker's Guide to Vala" 中有一个关于 CCode 参数的简短部分 和mailing list thread about calling a C macro from Vala with CCode。

但这两种资源都不能真正帮助我理解 CCode 的真正作用。它显然会影响 Vala 如何生成 C 代码，从 Hackers' Guide to Vala 我可以推断出 CCode 指令可能直接影响了我在遍历 Valas AST 时如何创建 CCode 树。

谁能解释一下 CCode 是做什么的？

【问题讨论】：

我找到了更多文档：live.gnome.org/Vala/Manual/Attributes#CCode_Attribute

【参考方案1】：

不幸的是，没有大量关于 CCode 的单独有意义的文档。您需要做的是将它与 Vala 附带的 VAPI 文件结合使用。在最基本的情况下，您可能会像这样使用宏：

[CCode(cname = "FOO", cheader_filename = "blah.h")]
public extern void foo();

这里我们设置cname（即，将被发送到C代码中的名称）和cheader_filename（即，应为#included的头文件）。大多数其他 CCode 属性控制如何处理数组。 array_length = false 表示数组的长度未知。这可以应用于参数或方法，表示应用于返回类型。例如：

[CCode(array_length = false)] public int[] x();
[CCode(array_null_terminated = true)] public FileStream[] y();
public int[] z();

在此示例中，x 的数组长度未知，预期的 C 原型为 int *x(void)，而y 的预期 C 原型为 FILE **y(void)，假设为空终止数组。最后，假设z 有一个数组长度输出参数（即int *z(int *length) 的原型，其中length 是指向存储返回数组长度的位置的指针。

所有这些也可以应用于参数。如果存在数组长度但它不是紧跟在数组之后的参数，则指定 array_length_pos 也很有用。如果参数是委托，target_pos 指定传递用户数据的位置（即与函数指针一起使用的 void*）。

还有各种用于委托、类和结构的 CCode 属性。 instance_pos 指定类/结构实例或委托用户数据的去向。所有位置参数都用浮点数指定。这允许对多个位置进行编码。例如，假设我们有一个 C 原型：

void foo(void* userdata, int length, double *dbl_array, void(*handler)(double,void*));

那么我们可以这样写：

[CCode(cname = "foo")]
public void foo([CCode(array_length_pos = 0.2)] double[] array, [CCode(target_pos = 0.1)] Handler func);

鉴于 Handler 在其他地方定义为委托，您可以看到 pos 值将参数放在参数 0 之后（即开始），然后按特定顺序。

类和结构具有处理初始化、销毁和引用计数的功能，但这些功能相当简单。处理泛型也有点复杂。同样，VAPI 是最好的洞察力来源。但是，这足以让您开始使用基本的 C 函数和宏。