検索結果

Fiddle::Pointer (69001.0)

• 2.7.0

• クラス

メモリ領域を表すクラスです。C 言語のポインタに相当します。

メモリ領域を表すクラスです。C 言語のポインタに相当します。

2.2.0 で削除された dl の DL::CPtr に対応します。
DL::CPtrとほぼ同じインターフェースを持ちます。

Fiddle::Pointer#+@ -> Fiddle::Pointer (63325.0)

• 2.7.0

• インスタンスメソッド

自身の指す値を Pointer にして返します。

自身の指す値を Pointer にして返します。

自身の指す値はポインタであると仮定します。
C 言語におけるポインタのポインタに対する間接参照 *p と同じです。

この返り値には、free 関数がセットされず、size は 0 とされます。

例:

require 'fiddle'

s = 'abc'
cptr = Fiddle::Pointer[s]
cref = cptr.ref
p cref.to_s(4).unpack('l*')[0] #=> 136121648
p cptr.to_i #=> 136121648
...

• Fiddle::Pointer

Fiddle::Pointer#-@ -> Fiddle::Pointer (63325.0)

• 2.7.0

• インスタンスメソッド

自身を指す Pointer オブジェクトを返します。 C 言語におけるポインタへのアドレス演算子の適用 &p と同じです。

自身を指す Pointer オブジェクトを返します。
C 言語におけるポインタへのアドレス演算子の適用 &p と同じです。

この返り値には、free 関数がセットされず、size は 0 とされます。

例:

require 'fiddle'

s = 'abc'
cptr = Fiddle::Pointer[s]
cref = cptr.ref
p cref.to_s(4).unpack('l*')[0] #=> 136121648
p cptr.to_i #=> 136121648
p cref.ptr.to_s ...

• Fiddle::Pointer

Fiddle::Pointer#ptr -> Fiddle::Pointer (63325.0)

• 2.7.0

• インスタンスメソッド

自身の指す値を Pointer にして返します。

自身の指す値を Pointer にして返します。

自身の指す値はポインタであると仮定します。
C 言語におけるポインタのポインタに対する間接参照 *p と同じです。

この返り値には、free 関数がセットされず、size は 0 とされます。

例:

require 'fiddle'

s = 'abc'
cptr = Fiddle::Pointer[s]
cref = cptr.ref
p cref.to_s(4).unpack('l*')[0] #=> 136121648
p cptr.to_i #=> 136121648
...

• Fiddle::Pointer

Fiddle::Pointer#ref -> Fiddle::Pointer (63325.0)

• 2.7.0

• インスタンスメソッド

自身を指す Pointer オブジェクトを返します。 C 言語におけるポインタへのアドレス演算子の適用 &p と同じです。

自身を指す Pointer オブジェクトを返します。
C 言語におけるポインタへのアドレス演算子の適用 &p と同じです。

この返り値には、free 関数がセットされず、size は 0 とされます。

例:

require 'fiddle'

s = 'abc'
cptr = Fiddle::Pointer[s]
cref = cptr.ref
p cref.to_s(4).unpack('l*')[0] #=> 136121648
p cptr.to_i #=> 136121648
p cref.ptr.to_s ...

• Fiddle::Pointer

絞り込み条件を変える

Fiddle::Pointer.[](val) -> Fiddle::Pointer (63325.0)

• 2.7.0

• 特異メソッド

与えられた val と関連した Pointer オブジェクトを生成して返します。

与えられた val と関連した Pointer オブジェクトを生成して返します。

val が文字列の場合は文字列が格納されているメモリ領域を指す Pointer
オブジェクトを返します。

IO オブジェクトの場合は FILE ポインタを表す Pointer オブジェクトを返します。

val に to_ptr メソッドが定義されている場合は、val.to_ptr を呼び、
Pointer オブジェクトに変換したものを返します。

val が整数の場合はそれをアドレスとする Pointer オブジェクトを返します。

上以外の場合は、整数に変換(to_int)し
それをアドレスとする P...

• Fiddle::Pointer

Fiddle::Pointer.to_ptr(val) -> Fiddle::Pointer (63325.0)

• 2.7.0

• 特異メソッド

与えられた val と関連した Pointer オブジェクトを生成して返します。

与えられた val と関連した Pointer オブジェクトを生成して返します。

val が文字列の場合は文字列が格納されているメモリ領域を指す Pointer
オブジェクトを返します。

IO オブジェクトの場合は FILE ポインタを表す Pointer オブジェクトを返します。

val に to_ptr メソッドが定義されている場合は、val.to_ptr を呼び、
Pointer オブジェクトに変換したものを返します。

val が整数の場合はそれをアドレスとする Pointer オブジェクトを返します。

上以外の場合は、整数に変換(to_int)し
それをアドレスとする P...

• Fiddle::Pointer

Fiddle::Pointer#+(n) -> Fiddle::Pointer (63322.0)

• 2.7.0

• インスタンスメソッド

自身のアドレスに n バイトを足した新しい Pointer オブジェクトを返します。

自身のアドレスに n バイトを足した新しい Pointer オブジェクトを返します。

この返り値には、free 関数がセットされず、size は 0 とされます。

@param n アドレスの増分を整数で指定します。

例:
require 'fiddle'

s = 'abc'
cptr = Fiddle::Pointer[s]
p cptr[0,1] #=> "a"
cptr += 1
p cptr[0,1] #=> "b"

• Fiddle::Pointer

Fiddle::Pointer#-(n) -> Fiddle::Pointer (63322.0)

• 2.7.0

• インスタンスメソッド

自身のアドレスから n バイトを引いた新しい Pointer オブジェクトを返します。

自身のアドレスから n バイトを引いた新しい Pointer オブジェクトを返します。

この返り値には、free 関数がセットされず、size は 0 とされます。

@param n アドレスの差分を整数で指定します。

例:
require 'fiddle'

s = 'abc'
cptr = Fiddle::Pointer[s]
cptr += 1
p cptr[0,1] #=> "b"
cptr -= 1
p cptr[0,1] #=> "a"

• Fiddle::Pointer

Fiddle::Pointer.malloc(size, free = nil) -> Fiddle::Pointer (63304.0)

• 2.7.0

• 特異メソッド

与えられた長さ size のメモリ領域を確保し、それを表す Pointer オブジェクトを生成して返します。

与えられた長さ size のメモリ領域を確保し、それを表す Pointer オブジェクトを生成して返します。

@param size 確保したいメモリ領域のサイズを整数で指定します。

@param free GC 時に呼ばれる Pointer オブジェクトの free 関数を
Fiddle::Function オブジェクトか整数で指定します。

• Fiddle::Pointer

絞り込み条件を変える

Fiddle::Pointer.new(addr, size = 0, free = nil) -> Fiddle::Pointer (63304.0)

• 2.7.0

• 特異メソッド

与えられた addr が指すメモリ領域を表す Pointer オブジェクトを生成して返します。

与えられた addr が指すメモリ領域を表す Pointer オブジェクトを生成して返します。

size を指定した場合、アドレス addr に確保されているメモリ領域のサイズは
size であると仮定されます。GC は free 関数を使用してメモリを解放します。

@param addr 生成する Pointer オブジェクトが指すアドレスを整数で指定します。

@param size 生成する Pointer オブジェクトが指すメモリ領域のサイズを整数で指定します。

@param free GC 時に呼ばれる free 関数を Fiddle::Function オブジェクトか
...

• Fiddle::Function
• Fiddle::Pointer

Fiddle::Pointer#size -> Integer (63055.0)

• 2.7.0

• インスタンスメソッド

自身の指す領域のサイズを返します。

自身の指す領域のサイズを返します。

基本的には Fiddle::Pointer.new で指定したサイズが返されます。
Fiddle::Pointer.to_ptr で文字列を変換したときは、そのバイト数が返されます。
Fiddle::Pointer#size= でこの値を変更することができます。

• Fiddle::Pointer

Fiddle::Pointer#==(other) -> bool (63037.0)

• 2.7.0

• インスタンスメソッド

ポインタの指すアドレスが同一ならばtrueを返します。

ポインタの指すアドレスが同一ならばtrueを返します。

@param other 比較対象の Pointer オブジェクト

例:

require 'fiddle'

s = 'abc'
cptr = Fiddle::Pointer[s]
cptr0 = Fiddle::Pointer[s]
cptr1 = cptr + 1

p cptr == cptr1 #=> false
p cptr == cptr0 #=> true

• Fiddle::Pointer

Fiddle::Pointer#eql?(other) -> bool (63037.0)

• 2.7.0

• インスタンスメソッド

ポインタの指すアドレスが同一ならばtrueを返します。

ポインタの指すアドレスが同一ならばtrueを返します。

@param other 比較対象の Pointer オブジェクト

例:

require 'fiddle'

s = 'abc'
cptr = Fiddle::Pointer[s]
cptr0 = Fiddle::Pointer[s]
cptr1 = cptr + 1

p cptr == cptr1 #=> false
p cptr == cptr0 #=> true

• Fiddle::Pointer

Fiddle::Pointer#free -> Fiddle::CFunc (63037.0)

• 2.7.0

• インスタンスメソッド

GC がメモリを解放するのに使用する Fiddle::CFunc オブジェクトを返します。

GC がメモリを解放するのに使用する Fiddle::CFunc オブジェクトを返します。

これは普通 Fiddle::Pointer#free= や Fiddle::Pointer.new によって設定されます。

• Fiddle::CFunc
• Fiddle::Pointer

絞り込み条件を変える

Fiddle::Pointer#[](offset) -> Integer (63022.0)

• 2.7.0

• インスタンスメソッド

自身の指すアドレスに offset バイトを足したメモリ領域の先頭を整数として返します。

自身の指すアドレスに offset バイトを足したメモリ領域の先頭を整数として返します。

@param offset 値を得たい領域のアドレスまでのオフセット
@raise Fiddle::DLError self の保持するポインタが NULL である場合に発生します

例:

require 'fiddle'

s = 'abc'
cptr = Fiddle::Pointer[s]
p cptr[0] #=> 97
p cptr[1] #=> 98

• Fiddle::Pointer

Fiddle::Pointer#[](offset, len) -> String (63022.0)

• 2.7.0

• インスタンスメソッド

自身の指すアドレスに offset バイトを足したメモリ領域の先頭 len バイトを複製し、 文字列として返します。

自身の指すアドレスに offset バイトを足したメモリ領域の先頭 len バイトを複製し、
文字列として返します。

(self + offset).to_s(len) と同等です。
offset + len が自身のサイズより小さいかを検証しません。

@param offset 値を得たい領域の先頭のアドレスまでのオフセットを整数で与えます。

@param len 値を得たい領域のサイズを指定します。
@raise Fiddle::DLError self の保持するポインタが NULL である場合に発生します

例:

require 'fiddle'

s = 'abc'
...

• Fiddle::Pointer

Fiddle::Pointer#[]=(offset, len, v) (63022.0)

• 2.7.0

• インスタンスメソッド

自身の指すアドレスに offset バイトを足したメモリ領域の先頭 len バイトに 文字列 v をコピーします。

自身の指すアドレスに offset バイトを足したメモリ領域の先頭 len バイトに
文字列 v をコピーします。

str のサイズが len より小さい場合は、残りの領域を 0 で埋めます。
コピー先の領域が len より大きいか検証しません。

@param offset 書き換えたいメモリ領域のオフセットを整数で与えます。

@param len 書き換えたいメモリ領域のサイズを整数で指定します。

@param v メモリ領域にセットしたいバイト列を文字列で指定します。

@raise Fiddle::DLError self の保持するポインタが NULL である場合に発生します...

• Fiddle::Pointer

Fiddle::Pointer#[]=(offset, n) (63022.0)

• 2.7.0

• インスタンスメソッド

自身の指すアドレスに offset バイトを足したメモリ領域を指定された n に書き換えます。

自身の指すアドレスに offset バイトを足したメモリ領域を指定された n に書き換えます。

@param n 整数を指定します。
@raise Fiddle::DLError self の保持するポインタが NULL である場合に発生します

例:

require 'fiddle'

s = 'abc'
cptr = Fiddle::Pointer[s]
cptr[0] = 65
p cptr.to_s #=> "Bbc"

• Fiddle::Pointer

Fiddle::Pointer#to_value -> object (63019.0)

• 2.7.0

• インスタンスメソッド

自身はヒープに確保された Ruby のオブジェクトを指すポインタであると仮定して、 自身が指すオブジェクトを返します。

自身はヒープに確保された Ruby のオブジェクトを指すポインタであると仮定して、
自身が指すオブジェクトを返します。

例:

require 'fiddle'

s = 'abc'
i = Fiddle.dlwrap(s)
cptr = Fiddle::Pointer.new(i)
p cptr.to_value #=> "abc"

• Fiddle::Pointer

絞り込み条件を変える

Fiddle::Pointer#<=>(other) -> Integer (63001.0)

• 2.7.0

• インスタンスメソッド

ポインタの指すアドレスの大小を比較します。

ポインタの指すアドレスの大小を比較します。

other より小さい場合は -1, 等しい場合は 0、other より大きい場合は
1を返します。

@param other 比較対象の Pointer オブジェクト

• Fiddle::Pointer

Fiddle::Pointer#free=(cfunc) (63001.0)

• 2.7.0

• インスタンスメソッド

GC が自身を解放するのに使う関数を Fiddle::CFunc で指定します。

GC が自身を解放するのに使う関数を Fiddle::CFunc で指定します。

@param cfunc 自身を解放するのに使われる関数を Fiddle::CFunc か整数で指定します。

• Fiddle::CFunc
• Fiddle::Pointer

Fiddle::Pointer#null? -> bool (63001.0)

• 2.7.0

• インスタンスメソッド

自身が NULL なら true を返します。そうでないなら false を返します。

自身が NULL なら true を返します。そうでないなら false を返します。

• Fiddle::Pointer

Fiddle::Pointer#size=(s) (63001.0)

• 2.7.0

• インスタンスメソッド

自身の指す領域のサイズを変えます。

自身の指す領域のサイズを変えます。

変更してもメモリの再割り当てはしません。単にオブジェクトが記録している
size の情報が変更されるだけです。

@param s 自身が指すメモリのサイズを整数で指定します。

• Fiddle::Pointer

Fiddle::Pointer#to_i -> Integer (63001.0)

• 2.7.0

• インスタンスメソッド

自身が指すアドレスを整数で返します。

自身が指すアドレスを整数で返します。

• Fiddle::Pointer

絞り込み条件を変える

Fiddle::Pointer#to_int -> Integer (63001.0)

• 2.7.0

• インスタンスメソッド

自身が指すアドレスを整数で返します。

自身が指すアドレスを整数で返します。

• Fiddle::Pointer

Fiddle::Pointer#to_s -> String (63001.0)

• 2.7.0

• インスタンスメソッド

自身が指す領域から長さ len の文字列を複製して返します。

自身が指す領域から長さ len の文字列を複製して返します。

len を省略した場合は、文字列の終りは '\0' であると仮定して、
strlen(3) を使って長さを算出します。

@param len 文字列の長さを整数で指定します。

• Fiddle::Pointer

Fiddle::Pointer#to_s(len) -> String (63001.0)

• 2.7.0

• インスタンスメソッド

自身が指す領域から長さ len の文字列を複製して返します。

自身が指す領域から長さ len の文字列を複製して返します。

len を省略した場合は、文字列の終りは '\0' であると仮定して、
strlen(3) を使って長さを算出します。

@param len 文字列の長さを整数で指定します。

• Fiddle::Pointer

Fiddle::Pointer#to_str -> String (63001.0)

• 2.7.0

• インスタンスメソッド

自身が指す領域から長さ len の文字列を複製して返します。

自身が指す領域から長さ len の文字列を複製して返します。

len を省略した場合は、self.size をその代わりに使います。

@param len 文字列の長さを整数で指定します。

• Fiddle::Pointer

Fiddle::Pointer#to_str(len) -> String (63001.0)

• 2.7.0

• インスタンスメソッド

自身が指す領域から長さ len の文字列を複製して返します。

自身が指す領域から長さ len の文字列を複製して返します。

len を省略した場合は、self.size をその代わりに使います。

@param len 文字列の長さを整数で指定します。

• Fiddle::Pointer

絞り込み条件を変える

Fiddle::Importer#import_symbol(name) -> Fiddle::Pointer (322.0)

• 2.7.0

• インスタンスメソッド

取り込んだライブラリからシンボルをインポートします。

取り込んだライブラリからシンボルをインポートします。

返り値はシンボルがロードされたメモリのアドレスを持つ Fiddle::Pointer
オブジェクトを返します。

@param name シンボル名(文字列)

• Fiddle::Importer
• Fiddle::Pointer

Fiddle::CStruct#to_ptr -> Fiddle::Pointer (304.0)

• 2.7.0

• インスタンスメソッド

保持している構造体へのポインタを返します。

保持している構造体へのポインタを返します。

• Fiddle::CStruct

fiddle (73.0)

• 2.7.0

• ライブラリ

*.dllや*.soなど、ダイナミックリンクライブラリを扱うためのライブラリです。

*.dllや*.soなど、ダイナミックリンクライブラリを扱うためのライブラリです。

dl と同等の機能を持ちますが、
dl は 2.0 以降deprecated となり、2.2.0 で削除されました。このライブラリ
を代わりに使います。

=== 使い方

通常は fiddle/import ライブラリを require して
Fiddle::Importer モジュールを使用します。
Fiddle モジュール自体はプリミティブな機能しか提供していません。
Fiddle::Importer モジュールは以下のようにユーザが定義した
モジュールを拡張する形で使います。

require ...

• Fiddle
• Fiddle::Closure
• Fiddle::Closure::BlockCaller
• Fiddle::DLError
• Fiddle::Function
• Fiddle::Handle
• Fiddle::Pointer
• fiddle/import
• fiddle/types

Fiddle::Function#call(*args) -> Integer|DL::CPtr|nil (55.0)

• 2.7.0

• インスタンスメソッド

関数を呼び出します。

関数を呼び出します。

Fiddle::Function.new で指定した引数と返り値の型に基いて
Ruby のオブジェクトを適切に C のデータに変換して C の関数を呼び出し、
その返り値を Ruby のオブジェクトに変換して返します。

引数の変換は以下の通りです。

: void* (つまり任意のポインタ型)
nil ならば C の NULL に変換されます
Fiddle::Pointer は保持している C ポインタに変換されます。
文字列であればその先頭ポインタになります。
IO オブジェクトであれば FILE* が渡されます。
整数であればそれがアドレスとみ...

• Fiddle::Function
• Fiddle::Pointer
• IO

Fiddle::Function.new(ptr, args, ret_type, abi=Fiddle::Function::DEFAULT, name: nil) -> Fiddle::Function (37.0)

• 2.7.0

• 特異メソッド

ptr (関数ポインタ)から Fiddle::Function オブジェクトを 生成します。

ptr (関数ポインタ)から Fiddle::Function オブジェクトを
生成します。

ptr には Fiddle::Handle から Fiddle::Handle#sym などで取りだした
関数ポインタ(を表す整数)、もしくは関数を指している
Fiddle::Pointer を渡します。

args、ret_type で関数の引数と返り値の型を指定します。これには以下の
定数が利用できます。「-TYPE_INT」 のように符号を反転させると unsigned を
意味します。
* Fiddle::TYPE_VOID
* Fiddle::TYPE_VOIDP
* Fidd...

• Fiddle::Function
• Fiddle::Handle
• Fiddle::Pointer

絞り込み条件を変える

Fiddle::CStruct (19.0)

• 2.7.0

• クラス

C の構造体を表すクラスです。

C の構造体を表すクラスです。

このクラスは直接は使わず、Fiddle::Importer#struct を用いて
このクラスを継承したクラスを生成し、それを利用します。

Fiddle::Importer#struct が生成するクラスには
構造体の各メンバへのアクセサが定義されています。
このアクセサはシグネチャの型とメンバ名に従って定義されます。
例えば
require 'fiddle/import'
include Fiddle::Importer
S = struct(["long foo", "void* bar"])
とすると、 S#foo, S#foo= という...

Fiddle::Importer#bind(signature, *opts) { ... } -> Fiddle::Function (19.0)

• 2.7.0

• インスタンスメソッド

Ruby のブロックを C の関数で wrap し、その関数をモジュールに インポートします。

Ruby のブロックを C の関数で wrap し、その関数をモジュールに
インポートします。

これでインポートされた関数はモジュール関数として定義されます。
また、Fiddle::Importer#[] で Fiddle::Function オブジェクトとして
取り出すことができます。

signature で関数の名前とシネグチャを指定します。例えば
"int compare(void*, void*)" のように指定します。

opts には :stdcall もしくは :cdecl を渡すことができ、
呼出規約を明示することができます。

@return インポートした関数を表す ...

• Fiddle::Function
• Fiddle::Importer