Ruby中使用SWIG编写ruby扩展模块实例

LUCIEN0 2019-04-01

在使用ruby/rails的过程中,确实发现有时性能不尽人意,如生成一个拥有600项的item的3层树形结构目录要花去20ms,为提高性能在学习用c/c++写ruby模块的过程中,认识了swig,rubyInline等一系列帮助编写c/c++来提升ruby性能的辅助工具。

rubyInline用于内嵌c/c++程序,简单快捷,swig则帮助我们更容易地用c/c++写出独立的ruby模块。

swig的入门使用方法

目标:用swig/c++编写一个ruby模块Test,并提供add方法作加法运算。

相关文件:
(1).test.i 接口
(2).test.h 头文件
(3).test.cxx 函数实现
(4).extconf.rb 用于生成makefile
(5).(自动)test_wrap.cxx swig生成的test封装
(6).(自动)Makefile Makefile文件由ruby extconf.rb得到
(7).(自动)test.so ruby模块 由make得到

1、建立接口文件test.i

代码如下:

%module test

%{

//包含头文件

#include "test.h"

%}

//接口add

int add(int,int);

2、编写wrap文件

代码如下:

swig -c++ -ruby test.i

得到test封装文件test_wrap.cxx

3、编写test.h与test.cxx

代码如下:

//test.h

#ifndef _TEST_TEST_H

#define _TEST_TEST_H

extern int add(int,int);

#endif

//test.cxx

#include "test.h"

int add(int left,int right)

{

        return left+right;

}

4、编写extconf.rb用于快速生成makefile

代码如下:

require 'mkmf'

dir_config 'test'

#stdc++库,add函数未用到

$libs = append_library $libs,'stdc++'

create_makefile 'test'

运行 ruby extconf.rb 得到 Makefile 文件

5、生成test模块

运行 make 得到模块 test.so

6、测试

代码如下:

irb

irb(main):001:0> require 'test'

=> true

irb(main):002:0> Test.add 3,4

=> 7

irb(main):003:0> Test.add 3333333333333333333333,44444444444444444

TypeError: Expected argument 0 of type int, but got Bignum 3333333333333333333333

        in SWIG method 'add'

        from (irb):3:in `add'

        from (irb):3

        from :0

irb(main):004:0>

测试成功

7、swig

swig支持很多c++的高级特性来编写ruby的模块,如类,继承,重载,模板,stl等。

8、相关链接

(1).swig
(2).swig/ruby 文档

9、备注

本文的add函数过于简单,对比ruby 3+4性能不升反降。

相关推荐