検索結果

VALUE Data_Make_Struct(VALUE klass, type, RUBY_DATA_FUNC mark, RUBY_DATA_FUNC free, type *svar) (1372.0)

• 3.4

• マクロ

type 型の構造体をヒープに割り当ててそれへのポインタを svar に代入し、クラス klass のインスタンスである Ruby のオブジェクトを生成し、それを返します。mark free はそれぞれマーク用・解放用の関数へのポインタです。 どちらも、必要ないときはかわりに 0 を渡します。

type 型の構造体をヒープに割り当ててそれへのポインタを
svar に代入し、クラス klass のインスタンスである
Ruby のオブジェクトを生成し、それを返します。mark
free はそれぞれマーク用・解放用の関数へのポインタです。
どちらも、必要ないときはかわりに 0 を渡します。

また RUBY_DATA_FUNC の定義は以下のようです。

typedef void (*RUBY_DATA_FUNC)(void *st)

第一引数 st には svar の値が渡されます。

使用例

struct mytype {
int i;
...

VALUE Data_Wrap_Struct(VALUE klass, RUBY_DATA_FUNC mark, RUBY_DATA_FUNC free, void *sval) (1372.0)

• 3.4

• マクロ

C の構造体 sval をラップして klass クラスの インスタンスである Ruby オブジェクトを生成し、それを返します。 mark、free はそれぞれ sval のマーク用・解放用の 関数へのポインタです。どちらも、必要ないときはかわりに 0 を渡します。

C の構造体 sval をラップして klass クラスの
インスタンスである Ruby オブジェクトを生成し、それを返します。
mark、free はそれぞれ sval のマーク用・解放用の
関数へのポインタです。どちらも、必要ないときはかわりに 0 を渡します。

また RUBY_DATA_FUNC の定義は以下のようです。

typedef void (*RUBY_DATA_FUNC)(void *st)

第一引数 st には sval が渡されます。

使用例

struct mytype {
int i;
char *s;
...

char * STR2CSTR(VALUE str) (172.0)

• 3.4

• マクロ

Ruby のオブジェクト str から C の文字列を取り出します。 str が String でない場合は to_str によって変換を試みます。

Ruby のオブジェクト str から C の文字列を取り出します。
str が String でない場合は to_str によって変換を試みます。

返り値を free したり直接書き換えたりしてはいけません。

STR2CSTR は、与えられたオブジェクトが文字列でなく to_str メソッ
ドを持つ場合、内部で to_str を呼び出して暗黙の型変換を行い、
それが保持する文字列ポインタを返します。
しかし、このAPIでは暗黙の型変換結果となるオブジェクトがどこからも
保持されないため、注意して使用しないと結果が GC される可能性があります。

Ruby 1.7 以降では代わりに S...

• StringValue
• StringValuePtr

VALUE CHR2FIX(char x) (100.0)

• 3.4

• マクロ

char 型の整数 x を Ruby の Fixnum に変換します。

char 型の整数 x を Ruby の Fixnum に変換します。

VALUE LL2NUM(long long v) (100.0)

• 3.4

• マクロ

例: long long n = 42; VALUE num = LL2NUM(n); // (long longの整数42をRubyのオブジェクトに変換)

例:
long long n = 42;
VALUE num = LL2NUM(n); // (long longの整数42をRubyのオブジェクトに変換)

絞り込み条件を変える

void Data_Get_Struct(VALUE obj, type, type *svar) (100.0)

• 3.4

• マクロ

Ruby のオブジェクト obj から type 型へのポインタを とりだし svar に代入します。

Ruby のオブジェクト obj から type 型へのポインタを
とりだし svar に代入します。

使用例

struct mytype {
int i;
char *s;
};

VALUE
my_i(VALUE self)
{
struct mytype *m;
Data_Get_Struct(self, struct mytype, m);
return INT2NUM(m->i);
}

VALUE INT2NUM(int i) (40.0)

• 3.4

• マクロ

任意の整数を Fixnum か Bignum に変換します。

任意の整数を Fixnum か Bignum に変換します。

例:
VALUE num = INT2NUM(42); //(Cの整数値42をRubyのオブジェクトに変換)

char * StringValuePtr(VALUE val) (40.0)

• 3.4

• マクロ

val が String でなければ to_str メソッドを使って String に変換し、 その実体のポインタを返します。

val が String でなければ to_str メソッドを使って String に変換し、
その実体のポインタを返します。

このマクロに渡した VALUE は ruby の GC から確実に保護されます。

struct RString * RSTRING(VALUE obj) (40.0)

• 3.4

• マクロ

引数 obj を RString 構造体にキャストして返します。

引数 obj を RString 構造体にキャストして返します。

@param obj Rubyの文字列オブジェクトを指定します。

void StringValue(VALUE val) (40.0)

• 3.4

• マクロ

val が String でなければ to_str メソッドを使って String に変換します。

val が String でなければ to_str メソッドを使って String に変換します。

このマクロに渡した VALUE は ruby の GC から確実に保護されます。

絞り込み条件を変える