Class: FFI::Function
- Defined in:
- ext/ffi_c/Function.c
Constant Summary
Constants inherited from Pointer
Instance Method Summary collapse
- #attach(module, name) ⇒ Object
- #autorelease ⇒ Object
- #autorelease=(autorelease) ⇒ Object
- #autorelease? ⇒ Boolean
- #call(*args) ⇒ Object
- #free ⇒ Object
- #initialize(*args) ⇒ Object constructor
Methods inherited from Pointer
#+, #==, #address, #inspect, #null?, #read_array_of_int, #read_array_of_long, #read_array_of_pointer, #read_array_of_type, #read_float, #read_int, #read_long, #read_long_long, #read_pointer, #read_string, #read_string_length, #read_string_to_null, size, #slice, #write_array_of_int, #write_array_of_long, #write_array_of_pointer, #write_array_of_type, #write_float, #write_int, #write_long, #write_long_long, #write_pointer, #write_string, #write_string_length
Constructor Details
#initialize(*args) ⇒ Object
113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 |
# File 'ext/ffi_c/Function.c', line 113
static VALUE
function_initialize(int argc, VALUE* argv, VALUE self)
{
VALUE rbReturnType = Qnil, rbParamTypes = Qnil, rbProc = Qnil, rbOptions = Qnil;
VALUE rbFunctionInfo = Qnil;
VALUE infoArgv[3];
int nargs;
nargs = rb_scan_args(argc, argv, "22", &rbReturnType, &rbParamTypes, &rbProc, &rbOptions);
//
// Callback with block,
// e.g. Function.new(:int, [ :int ]) { |i| blah }
// or Function.new(:int, [ :int ], { :convention => :stdcall }) { |i| blah }
//
if (rb_block_given_p()) {
if (nargs > 3) {
rb_raise(rb_eArgError, "cannot create function with both proc/address and block");
}
rbOptions = rbProc;
rbProc = rb_block_proc();
} else {
// Callback with proc, or Function with address
// e.g. Function.new(:int, [ :int ], Proc.new { |i| })
// Function.new(:int, [ :int ], Proc.new { |i| }, { :convention => :stdcall })
// Function.new(:int, [ :int ], addr)
// Function.new(:int, [ :int ], addr, { :convention => :stdcall })
}
infoArgv[0] = rbReturnType;
infoArgv[1] = rbParamTypes;
infoArgv[2] = rbOptions;
rbFunctionInfo = rb_class_new_instance(rbOptions != Qnil ? 3 : 2, infoArgv, rbffi_FunctionTypeClass);
function_init(self, rbFunctionInfo, rbProc);
return self;
}
|
Instance Method Details
#attach(module, name) ⇒ Object
243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 |
# File 'ext/ffi_c/Function.c', line 243
static VALUE
function_attach(VALUE self, VALUE module, VALUE name)
{
Function* fn;
char var[1024];
Data_Get_Struct(self, Function, fn);
if (fn->info->parameterCount == -1) {
rb_raise(rb_eRuntimeError, "cannot attach variadic functions");
return Qnil;
}
if (!rb_obj_is_kind_of(module, rb_cModule)) {
rb_raise(rb_eRuntimeError, "trying to attach function to non-module");
return Qnil;
}
if (fn->methodHandle == NULL) {
fn->methodHandle = rbffi_MethodHandle_Alloc(fn->info, fn->memory.address);
}
//
// Stash the Function in a module variable so it does not get garbage collected
//
snprintf(var, sizeof(var), "@@%s", StringValueCStr(name));
rb_cv_set(module, var, self);
rb_define_singleton_method(module, StringValueCStr(name),
rbffi_MethodHandle_CodeAddress(fn->methodHandle), -1);
rb_define_method(module, StringValueCStr(name),
rbffi_MethodHandle_CodeAddress(fn->methodHandle), -1);
return self;
}
|
#autorelease ⇒ Object
293 294 295 296 297 298 299 300 301 |
# File 'ext/ffi_c/Function.c', line 293
static VALUE
function_autorelease_p(VALUE self)
{
Function* fn;
Data_Get_Struct(self, Function, fn);
return fn->autorelease ? Qtrue : Qfalse;
}
|
#autorelease=(autorelease) ⇒ Object
281 282 283 284 285 286 287 288 289 290 291 |
# File 'ext/ffi_c/Function.c', line 281
static VALUE
function_set_autorelease(VALUE self, VALUE autorelease)
{
Function* fn;
Data_Get_Struct(self, Function, fn);
fn->autorelease = RTEST(autorelease);
return self;
}
|
#autorelease? ⇒ Boolean
293 294 295 296 297 298 299 300 301 |
# File 'ext/ffi_c/Function.c', line 293
static VALUE
function_autorelease_p(VALUE self)
{
Function* fn;
Data_Get_Struct(self, Function, fn);
return fn->autorelease ? Qtrue : Qfalse;
}
|
#call(*args) ⇒ Object
233 234 235 236 237 238 239 240 241 |
# File 'ext/ffi_c/Function.c', line 233
static VALUE
function_call(int argc, VALUE* argv, VALUE self)
{
Function* fn;
Data_Get_Struct(self, Function, fn);
return (*fn->info->invoke)(argc, argv, fn->memory.address, fn->info);
}
|
#free ⇒ Object
303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 |
# File 'ext/ffi_c/Function.c', line 303
static VALUE
function_release(VALUE self)
{
Function* fn;
Data_Get_Struct(self, Function, fn);
if (fn->closure == NULL) {
rb_raise(rb_eRuntimeError, "cannot free function which was not allocated");
}
rbffi_Closure_Free(fn->closure);
fn->closure = NULL;
return self;
}
|