如何在Vala中使用CCode属性？

Question

我正在尝试使用Vala中的C宏.在我看来,这应该可以使用CCode指令,但我找不到任何有关如何使用它的有意义的文档.

在"黑客的Vala指南"中有一个关于CCode参数的简短部分, 以及一个关于使用CCode从Vala调用C宏的邮件列表线程.

但这两种资源都无法帮助我理解CCode的真正作用.它显然会影响Vala如何生成C代码,从黑客指南到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(即应该是#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函数和宏.