我正在尝试使用来自vala的c宏。在我看来,使用ccode指令应该可以做到这一点,但是我没有找到任何关于如何使用它的有意义的文档。
"The Hacker's Guide to Vala"中有一个关于ccode参数的简短部分。
以及amailing list thread about calling a C macro from Vala with CCode
但这两种资源都不能真正帮助我理解ccode的真正功能。它显然影响了vala生成c代码的方式,根据Hackers' Guide to Vala我可以推断,c code指令可能会直接影响遍历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将具有未知的数组长度,并且具有预期的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(即,开始)之后,然后按特定顺序放置。
类和结构具有处理初始化、销毁和引用计数的函数,但这些函数相当简单。处理泛型也有点复杂。再说一遍,vapis是最好的洞察力来源。不过,这足以让你开始你的基本C函数和宏。

07-27 19:31