SWIG 基本概念和入門


C 和 C++ 被公認為(理當如此)創建高性能代碼的首選平台。對開發人員的一個常見要求是向腳本語言接口公開 C/C++ 代碼,這正是 Simplified Wrapper and Interface Generator (SWIG) 的用武之地。SWIG 允許您向廣泛的腳本語言公開 C/C++ 代碼,包括 Ruby、Perl、Tcl 和 Python。本文使用 Ruby 作為公開 C/C++ 功能的首選腳本接口。要理解本文,您必須具備 C/C++ 與 Ruby 方面的相應知識。

SWIG 是一款不錯的工具,可適合多種場景,其中包括:

  • 向 C/C++ 代碼提供一個腳本接口,使用戶更容易使用
  • 向您的 Ruby 代碼添加擴展或將現有的模塊替換為高性能的替代模塊
  • 提供使用腳本環境對代碼執行單元和集成測試的能力
  • 使用 TK 開發一個圖形用戶接口並將它與 C/C++ 后端集成

此外,與 GNU Debugger 每次都需觸發相比,SWIG 要容易調試得多。

使用 SWIG 編寫 Hello World

作為輸入,SWIG 需要一個包含 ANSI C/C++ 聲明和 SWIG 指令的文件。我將此輸入文件稱為 SWIG 接口文件。一定要記住,SWIG 僅需要足夠生成包裝器代碼的信息。該接口文件通常具有 *.i 或 *.swg 擴展名。以下是第一個擴展文件 test.i:

1
2
%module test
%constant char* Text = "Hello World with SWIG"

使用 SWIG 運行此代碼:

1
swig –ruby test.i

第二個代碼段中的命令行在當前文件夾中生成一個名為 test_wrap.c 的文件。現在,您需要在此 C 文件中創建一個共享庫。以下是該命令行:

1
2
bash$ gcc –fPIC –c test_wrap.c –I$RUBY_INCLUDE
bash$ gcc –shared test_wrap.o –o test_wrap.so –lruby –L$RUBY_LIB

就這么簡單。您已准備就緒,那就觸發交互式 Ruby shell (IRB),輸入 require 'test_wrap' 來檢查 Ruby Test 模塊和它的內容。以下是擴展的 Ruby 端:

1
2
3
4
5
6
irb(main):001:0> require 'test_wrap'
=> true
irb(main):002:0> Test.constants
=> ["Text"]
irb(main):003:0> Test:: Text
=> "Hello World with SWIG"

SWIG 可用於生成各種語言擴展,只需運行 swig –help 檢查所有的可用選項。對於 Ruby,可以輸入 swig –ruby <interface file>;對於 Perl,可以使用 swig –perl <interface file>

也可以使用 SWIG 生成 C++ 代碼:只需在命令行使用 –c++ 即可。在前面的示例中,運行 swig –c++ –ruby test.i 會在當前文件夾中生成一個名為 test_wrap.cxx 的文件。

 

參考文檔:https://www.ibm.com/developerworks/cn/aix/library/au-swig/


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM