PageRenderTime 34ms CodeModel.GetById 8ms RepoModel.GetById 1ms app.codeStats 0ms

/tags/rel-1.3.35/Examples/ruby/index.html

#
HTML | 94 lines | 74 code | 20 blank | 0 comment | 0 complexity | 1be53227317a2386bde41187fa4b0c59 MD5 | raw file
Possible License(s): LGPL-2.1, Cube, GPL-3.0, 0BSD, GPL-2.0 
    

  1. 

  2. <head>
    3. 

  3. <title>SWIG:Examples:ruby</title>
    4. 

  4. </head>
    5. 

  5. 

  6. <body bgcolor="#ffffff">
    7. 

  7. <H1>SWIG Ruby Examples</H1>
    8. 

  8. 

  9. <p>
    10. 

  10. The following examples illustrate the use of SWIG with Ruby.
    11. 

  11. 

  12. <ul>
    13. 

  13. <li><a href="simple/index.html">simple</a>.  A minimal example showing how SWIG can
    14. 

  14. be used to wrap a C function, a global variable, and a constant.
    15. 

  15. <li><a href="constants/index.html">constants</a>.  This shows how preprocessor macros and
    16. 

  16. certain C declarations are turned into constants.
    17. 

  17. <li><a href="variables/index.html">variables</a>. An example showing how to access C global variables from Ruby.
    18. 

  18. <li><a href="value/index.html">value</a>. How to pass and return structures by value.
    19. 

  19. <li><a href="class/index.html">class</a>. Wrapping a simple C++ class.
    20. 

  20. <li><a href="reference/index.html">reference</a>. C++ references.
    21. 

  21. <li><a href="pointer/index.html">pointer</a>. Simple pointer handling.
    22. 

  22. <li><a href="funcptr/index.html">funcptr</a>. Pointers to functions.
    23. 

  23. <li><a href="enum/index.html">enum</a>. Enumeration.
    24. 

  24. </ul>
    25. 

  25. 

  26. <h2>Compilation Issues</h2>
    27. 

  27. 

  28. <ul>
    29. 

  29. <li>To create a Ruby extension, SWIG is run with the following options:
    30. 

  30. 

  31. <blockquote>
    32. 

  32. <pre>
    33. 

  33. % swig -ruby interface.i
    34. 

  34. </pre>
    35. 

  35. </blockquote>
    36. 

  36. 

  37. <li>
    38. 

  38. Please see the <a href="../../Doc/Manual/Windows.html">Windows</a> page in the main manual for information on using the examples on Windows. <p>
    39. 

  39. </li>
    40. 

  40. 

  41. <li>On Unix the compilation of examples is done using the file <tt>Example/Makefile</tt>.  This
    42. 

  42. makefile performs a manual module compilation which is platform specific.  Typically,
    43. 

  43. the steps look like this (Linux):
    44. 

  44. 

  45. <blockquote>
    46. 

  46. <pre>
    47. 

  47. % swig -ruby interface.i
    48. 

  48. % gcc -fpic -c interface_wrap.c -I/usr/local/lib/ruby/1.4/i686-linux
    49. 

  49. % gcc -shared interface_wrap.o $(OBJS) -o interface.so 
    50. 

  50. % ruby
    51. 

  51. require 'interface'
    52. 

  52. Interface.blah(...)
    53. 

  53. ...
    54. 

  54. </pre>
    55. 

  55. </blockquote>
    56. 

  56. 

  57. <li>The politically "correct" way to compile a Ruby extension is to follow the steps
    58. 

  58. described <tt>README.EXT</tt> in Ruby distribution:
    59. 

  59. 

  60. <p>
    61. 

  61. <ol>
    62. 

  62. <li>Create a file called <tt>extconf.rb</tt> that looks like the following:
    63. 

  63. 

  64. <blockquote>
    65. 

  65. <pre>
    66. 

  66. require 'mkmf'
    67. 

  67. create_makefile('interface')
    68. 

  68. </pre>
    69. 

  69. </blockquote>
    70. 

  70. <li>Type the following to build the extension:
    71. 

  71. 

  72. <blockquote>
    73. 

  73. <pre>
    74. 

  74. % ruby extconf.rb
    75. 

  75. % make
    76. 

  76. </pre>
    77. 

  77. </blockquote>
    78. 

  78. </ol>
    79. 

  79. </ul>
    80. 

  80. 

  81. <h2>Compatibility</h2>
    82. 

  82. 

  83. The examples have been extensively tested on the following platforms:
    84. 

  84. 

  85. <ul>
    86. 

  86. <li>Linux
    87. 

  87. </ul>
    88. 

  88. 

  89. Your mileage may vary.  If you experience a problem, please let us know by 
    90. 

  90. contacting us on the <a href="http://www.swig.org/mail.html">mailing lists</a>.
    91. 

  91. </body>
    92. 

  92. </html>
    93. 

  93. 

  94. 

  95.