Question

我正在尝试使用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的作用吗？

Answer 1

不幸的是，关于CCode的文档并不多，仅此一点是有道理的。您需要做的是将它与Vala附带的VAPI文件结合使用。在最基本的情况下，你可能会使用这样的宏：

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

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

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

在此示例中，x将具有未知的数组长度并且具有int *x(void)的预期C原型，而假设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函数和宏。

如何在Vala中使用CCode属性？

1 个答案: