Ruby 2.3.0 リファレンスマニュアル > ライブラリ一覧 > fiddle/importライブラリ > Fiddle::Importerモジュール > struct

instance method Fiddle::Importer#struct

struct(signature) -> Class[permalink][rdoc]

C の構造体型に対応する Ruby のクラスを構築して返します。

構造体の各要素は C と似せた表記ができます。そしてそれを 配列で signature に渡してデータを定義します。例えば C における

struct timeval {
  long tv_sec;
  long tv_usec;
};

という構造体型に対応して

Timeval = struct(["long tv_sec", "long tv_usec"])

として構造体に対応するクラスを生成します。

このメソッドが返すクラスには以下のメソッドが定義されています

• クラスメソッド malloc
• initialize
• to_ptr
• to_i
• 構造体の各メンバへのアクセサ

返されるクラスは Fiddle::CStruct を継承しています。詳しくは そちらを参照してください。

[PARAM] signature:

構造体の各要素を文字列で表現したものの配列

require 'fiddle/import'

module M
  extend Fiddle::Importer
  dlload "libc.so.6"
  extern "int gettimeofday(void*, void*)"
  Timeval = struct(["long tv_sec", "long tv_usec"])
end

time = Timeval.malloc
M.gettimeofday(time, Fiddle::NULL)
p time.tv_sec
p time.tv_usec