在“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(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函数和宏.
