如何在Vala中使用CCode属性？

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

解决方法

不幸的是,没有大量关于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将具有未知的数组长度并且具有int * x(void)的预期C原型,而假设y具有带有预期的C原型FILE ** y(void)的以null结尾的数组.最后,假设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函数和宏.