Skip to content

red-data-tools/extpp

Repository files navigation

README

Name

Ext++

Description

Ext++ is a Ruby extension that provides C++ API for writing Ruby extension.

You can write your Ruby extension easier than Ruby's C API. Because Ext++'s C++ API reduces duplicated code needed for Ruby's C API.

You can use all Ruby's C API without any adapter layer. Because you can use C API directory from C++.

Install

% gem install extpp

How to use

Here is an example to create Hello class.

Create hello.cpp:

#include <ruby.hpp>

RB_BEGIN_DECLS

void
Init_hello(void)
{
  rb::Class klass("Hello");
  klass.define_method("initialize", [](VALUE rb_self, int argc, VALUE *argv) {
      VALUE rb_name;
      rb_scan_args(argc, argv, "1", &rb_name);
      rb::Object self(rb_self);
      self.ivar_set("@name", rb_name);
      return Qnil;
    });
  klass.define_method("greet", [](VALUE rb_self) {
      rb::Object self(rb_self);
      rb::Object prefix(rb_str_new_cstr("Hello "));
      auto message = prefix.send("+", {self.ivar_get("@name")});
      return static_cast<VALUE>(message);
    });
}

RB_END_DECLS

This code equals to the following Ruby code:

class Hello
  def initialize(name)
    @name = name
  end

  def greet
    "Hello " + @name
  end
end

Create extconf.rb:

require "extpp"

create_makefile("hello")

Create Makefile:

% ruby extconf.rb

Build this extension:

% make

Now, you can use this extension:

% ruby -r ./hello -e 'p Hello.new("me").greet'
"Hello me"

License

Copyright (C) 2017-2021 Sutou Kouhei

The 2-Clause BSD License. See LICENSE.txt for details.