c - rb_iv_get 和 rb_iv_set 对比。 Data_Wrap_Struct 用于创建自定义类

Question

rb_iv_get 和 rb_iv_set 对比。 Data_Wrap_Struct 用于自定义类

因此，在阅读 Ruby 扩展 API 时，我发现 Data_Wrap_Struct 可以将指针转换为 Ruby 对象(对吗？)。然而，当我尝试使用 is 时，我不断收到随机错误等等，所以我有点想切换到类似的东西:

void Init_custom() {
    //cCustom declared as VALUE higher in the code
    cCustom = rb_define_class("Custom", T_OBJECT);
    rb_define_method(mTester, "initialize", init_Custom, 1);
    rb_define_method(mTester, "someValue", someValue_get_Custom, 0);
    rb_define_method(mTester, "someValue=", someValue_set_Custom, 1);
    //And so on.
}

其次，someValue_get_Custom 和 someValue_set_Custom 将是:

VALUE someValue_get_Custom(VALUE self) {
    return rb_iv_get(self, "@someValue")
}

VALUE someValue_set_Custom(VALUE self, VALUE val) {
    return rb_iv_set(self, "@someValue", val) //or do I have to do return val;?
}

另一种选择是创建一个 C 版本的 attr_accessor，这将使代码稍微短一些并且更干燥，但它仍然是计划 B 的一部分(使用 rb_iv_ 设置/获取).

---

现在，我真的很想知道如何使用 Data_Wrap_Struct，因为我怀疑它可能比使用 rb_iv_set 和 rb_iv_get，但如果不是我想的那样，那么我将不得不求助于计划 B。

所以，我想真正的问题是:

Data_Wrap_Struct 究竟做了什么以及如何正确使用它或只是使用它不会出错。

---

哦，我差点忘了，还有几个与Data_Wrap_Struct相关的问题:

mark 参数(一个函数)到底做了什么？它说如果对象未在任何地方被引用，则将标记参数设置为 0，但如果它在某处被引用(可能是 RArray)怎么办？

其次，free 参数(也是一个函数)是否是一个简单的函数，可以释放为该对象分配的内存？

垃圾收集器是否向这两个函数传递了任何东西，也许是 VALUE self？

谢谢!

Answer 1

这些问题很多，我会尽量用几句话回答那些我能回答的问题。

将 Data_Wrap_Struct 视为一个薄的 Ruby 包装器，它在 Ruby 中作为“普通”对象可见，但实际上带有对 C 结构的引用(理论上可以是任何东西，但确实有意义对于复杂类型)在它的引擎盖下。这个想法是，通过这种方式，您可以将一个结构附加到一个 Ruby 对象，并且在任何时候只要 Ruby 通过向该包装器对象发送消息来请求它，就可以访问该结构数据。然后在 C 中，您从结构中检索数据，将其转换为 ruby​​ish 并将其传回。或者，当您被要求在包装器对象中设置数据时，您可以执行相反的操作 - 您将 Ruby 数据转换为适合该结构的数据。

当垃圾收集器决定收集包装器对象时，它还想释放底层的 C 结构 - 这是 free 参数的工作，它是一个指向采用结构的函数的函数指针type 作为参数并且应该释放该结构的内存。

mark 参数要复杂得多，我建议您将其作为一个单独的问题发布。好处是:大多数时候您不需要它。

rb_iv_get、rb_iv_set 以及 rb_ivar_get 和 rb_ivar_set 用于完全不同的目的。他们设置了你的 Ruby 对象的实例变量，我猜这就是你真正想要的。这里的要点是您在这里获取/设置 VALUE，即您在这里使用 Ruby 对象而不是普通的 C 类型。

您不必编写 C 版本的 attr_accessor，它已经存在:rb_attr。

总结一下:Data_Wrap_Struct 在您的 C 结构上包装了一个容器对象，但除此之外还没有提供任何功能。如果您打算拥有 attr_accessor 功能，您应该在 Init 方法中使用 rb_attr。如果您确实想显式设置或获取实例变量，请使用 rb_iv*。`

---

我同意缺乏关于如何为 Ruby 编写 C 扩展的明确资源。不过，有很多博客文章。根据我自己的经验，我可能会从 Serabe 在评论中提到的 Pickaxe PDF 开始，并且在 Ruby 源代码 (README.EXT) 中有一个非常简洁的介绍。之后，您可以做的最好的事情就是查看 Ruby 源代码中 ext 目录中的扩展。选择一个您熟悉的或您喜欢其功能的并使用它。随时准备好 Ruby 源代码。如果您不知道某个特定函数的作用，请在源代码中查找它的声明以至少了解它的作用。您无需第一眼就理解所有内容，但通常足以让您继续执行任务。