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

在使用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性能不升反降。