[文件] SWIG/Ruby

看板Ruby作者godfat (godfat 真常)時間18年前 (2006/08/06 16:37)推噓4(4推 0噓 5→)

留言9則, 5人參與討論串1/3 (看更多)

http://www.swig.org/ SWIG is an interface compiler that connects programs written in C and C++ with scripting languages such as Perl, Python, Ruby, and Tcl. 也就是，讓 C/C++ 與 scripting language 溝通的介面產生器目前支援 13 種 scripting language: * Allegro Common Lisp * C# * Chicken * Guile * Java * Modula-3 * Mzscheme * OCAML * Perl * PHP * Python * Ruby * Tcl 之前我測了一些 Ruby 與 C++ 的溝通方式，以下將簡單介紹一下測試的方法首先先看到使用方式，我想這個應該是最重要的部份畢竟如果使用不便，那其他的也不用再多說什麼了… （以下由於 BBS 之故，稍作排版修改）以下這個程式是一個簡單的 type wrapper,（傳值版）由 template parameter 指定型別， data() 當 getter, data(type) 當 setter. 另外在 c'tor 和 d'tor 中插入 IO 來追蹤物件的生成與摧毀 // in Wrapper.h #include <iostream> template <class Data> class Wrapper{ public: Wrapper(Data new_data): data_(new_data){ std::cout << "C++: Wrapper is created, which is '" << data_ << "' .\n"; } ~Wrapper(){ std::cout << "C++: Wrapper is decayed, which is '" << data_ << "' .\n"; } Data data() const{ return data_; } void data(Data new_data){ data_ = new_data; } private: Data data_; }; 有了這個 .h 檔的介面後（這裡同時也包含實作），接下來我們需要的是一個由 swig 產生的膠水，將 C++ 介面與 Ruby 介面混合暫時命名為：Wrapper.i, 詳細做法等一下我們再來看總之最終我們將產生一個動態連結檔，也就是一個 Ruby 的 module, 叫 Wrapper 不過需要一提的是，由於 Ruby 本身不支援 template, 所以我們在 Wrapper.i 中必須明確指出我們需要什麼型別，否則 Ruby 會無法使用（更明確來講，純 template 根本無法 compile）所以在 Wrapper.i 中，裡面有一行是這個： %template(Integer) Wrapper<int>; 這句話的意思是，將 Wrapper<int> 這個型別取作 Integer 於是 Ruby module 做好後，可以使用 Integer 這個型別雖然我中間還有很多測試，不過直接看目前的最後結果吧寫一個 Ruby 程式，內容如下： #!ruby # in test.rb require 'Wrapper' # 讀入剛剛做好的 Wrapper module class Test < Wrapper::Integer # 繼承 C++ 寫好的 Wrapper<int> def initialize(new_data) # c'tor 其實可以省略，因為可以使用 super(new_data) # C++ 中寫好的 Wrapper<int> end # 這裡只是展示 super 是可以用的 def plus(num) data(data + num) data end end # 正式測試開始 fat = Test.new(123) # 建構出 Test 物件，傳入 123 當引數 puts fat.plus(7) # output: 130 fat.data(456) # 設值為 456 puts fat.plus(4) # output: 460 ok, 可是原本插入 C++ 的 c'tor 中的 IO 呢？整個程式的輸出結果是這樣： C++: Wrapper is created, which is '123' . 130 460 C++: Wrapper is decayed, which is '460' . 也就是說，C++ 的 c'tor 與 d'tor 有被確實喚起這樣說不定可以替 Ruby 實作出 d'tor...不過這是題外話另外，剛剛程式中的 fat.data 與 fat.data(456) 確實是喚起正確的 getter 與 setter, 可是 Ruby 沒有 overload? 我沒有實際去看，但我猜他內部大概是這樣實作的： def data(*args) case args.size when 0 then return self.data_a when 1 then return self.data_b(args[0]) end end 所以如果你想要重新定義其中一個 overloaded method, 做不到… 可能必須找到他實際的名字才有辦法那麼我們再來看到由 C++ 呼喚 Ruby... 否則不就太寂寞了嗎？基本上 Ruby 本身就提供了良好與 C 溝通的機制，照用不就好了？是這樣說沒錯，可是說真的我很討厭 C 的介面…囧rz 常常會要你記下一堆有的沒的，感覺很討厭所以我覺得需要一個 C++ 的 wrapper, 一個可以輕鬆呼叫 Ruby 的方式像上面推文中所提到的，我找到這個： http://www.sourcepole.com/sources/software/c++ruby/ 不過這個東西實在是寫得不好，沒有處理 finalize 的部份不知道還有沒有其他類似的 wrapper 可以用，所以我就暫時用這個來改改寫他 singleton 的實作，還有記得在 d'tor 中呼叫 ruby_finalize(); 最後的結果是，我可以這樣寫： #include "rubyeval.h" // 就是上面抓來的那個 #include <ruby.h> // embedded ruby 必要的東西，去 ruby-lang 就可以抓 int main(){ RubyEval& ruby = RubyEval::instance(); ruby.eval("require 'Wrapper'"); // 直接用字串執行 Ruby // 這邊是含入剛剛做好的 C++ => Ruby mod // 當然這東西要先 compile 好 ruby.eval("fat = Wrapper::Integer.new(123)"); // 直接建立物件 std::cout << NUM2INT(ruby.eval("fat.data")) << std::endl; // 輸出 123 ruby.eval("fat.data(456);"); // 設值 456 std::cout << NUM2INT(ruby.eval("fat.data")) << std::endl; // 輸出 456 ruby.run_file("test.rb"); // 直接執行 ruby 程式 } 那個 test.rb, 就是上面寫好拿來測試 Ruby 呼叫 C++ 的程式於是整個輸出結果就是： C++: Wrapper is created, which is '123' . 123 456 C++: Wrapper is created, which is '123' . 130 460 C++: Wrapper is decayed, which is '460' . C++: Wrapper is decayed, which is '456' . 第一行是從 C++ 建構的 Integer; 123, 456 則是 cout 輸出的第四行的 123 則是 test.rb 產生 class Test < Wrapper::Integer 那個 130, 460 則是 Ruby 的 puts 產生出來的最後兩個 decayed 則是 Ruby 的 gc 正確在程式結束時摧毀物件輸出的順序剛好跟 c'tor 反過來，一切正常最後就來看怎麼實現這個的 Wrapper.i 是這樣寫的： %module Wrapper %{ #include "Wrapper.h" %} %include "Wrapper.h" %template(Integer) Wrapper<int>; 這些語法請參考 SWIG 的網站，那邊都有詳細說明甚至是 C++ 的多重繼承，在 Ruby 中也能使用當然多少可能會有點限制，但似乎可以實現一定的功能下指令： swig -c++ -ruby Wrapper.i 這樣就可以以 Wrapper.i 這個介面檔實作出由 Ruby 溝通 C++ 的程式那個程式會叫做 Wrapper_wrap.cxx, 也就是 YOUR_NAME_wrap.cxx 再來就是將所有的程式打包成一個動態連結檔了，所有的檔案是： Wrapper.h (包含實作), Wrapper_wrap.cxx (SWIG 的膠水) 方便的做法是使用 Ruby 的 mod, 叫 mkmf 寫一個 Ruby 程式叫 mkmf.rb, 內容是： require 'mkmf' $libs = append_library($libs, "stdc++") create_makefile(ARGV[0]) 這邊是由於我個人方便，所以這樣寫的第一行含入 mkmf, 第二行是因為我用到 C++ 標準函數庫（cout），所以必須連結 stdc++ 才行（我的系統是 gcc, VC++ 的話我不清楚）接著由 create_makefile 產生出我要的 makefile, 名稱由 cmd line 輸入這邊我是輸入 Wrapper （btw, 有人知道 stdc++ 可否動態連結嗎？）接著就可以由 make 將 Wrapper.h 和 Wrapper_wrap.cxx 合併做出 Wrapper.so （我想 VC++ 系統應該會做出 Wrapper.dll 之類的）最後要提的是，整個程式的執行環境由於我是在 cygwin 下作業的，所以獨立執行這些程式需要的是： cygwin1.dll 1.78 MB cygruby18.dll 703 KB cygcrypt-0.dll 6.5 KB 我想如果在 windows 下由 VC++ compile 的話，應該就只會需要 Ruby interpreter 的 dll 檔（這裡是 cygruby18.dll）不過我就沒有做這一步的測試了，留給讀者當作練習吧 XD （忽然心血來潮所以整理了這些東西） -- Nobody can take anything away from him. Nor can anyone give anything to him. What came from the sea, has returned to the sea. Chrono Cross -- ※ 發信站: 批踢踢實業坊(ptt.cc) ◆ From: 220.135.28.18