class Fiddle::Closure

Родитель:: Объект

Описание

Обёртка для FFI-замыканий, для обработки обратных вызовов.

Пример

closure = Class.new(Fiddle::Closure) {
  def call
    10
  end
}.new(Fiddle::TYPE_INT, [])
   #=> #<#<Class:0x0000000150d308>:0x0000000150d240>
func = Fiddle::Function.new(closure, [], Fiddle::TYPE_INT)
   #=> #<Fiddle::Function:0x00000001516e58>
func.call
   #=> 10

Атрибуты

args[R]

аргументы FFI-замыкания

ctype[R]

тип возвращаемого значения FFI-замыкания

Общедоступные методы класса

create(*args) { |closure| ... } Показать исходный код

# File ext/fiddle/lib/fiddle/closure.rb, line 16
def create(*args)
  if block_given?
    closure = new(*args)
    begin
      yield(closure)
    ensure
      closure.free
    end
  else
    new(*args)
  end
end

Создать новое замыкание. Если задан блок, созданное замыкание автоматически освобождается после выполнения данного блока.

Все переданные аргументы передаются в Fiddle::Closure.new. Таким образом, использование этого метода без блока эквивалентно Fiddle::Closure.new.

Пример

Fiddle::Closure.create(TYPE_INT, [TYPE_INT]) do |closure|
  # closure is freed automatically when this block is finished.
end

new(ret, args, abi = Fiddle::DEFAULT) Показать исходный код

static VALUE
initialize(int argc, VALUE *argv, VALUE self)
{
    initialize_data data;
    data.self = self;
    data.argc = argc;
    data.argv = argv;
    return rb_rescue(initialize_body, (VALUE)&data,
                     initialize_rescue, (VALUE)&data);
}

Создать новый объект Closure.

ret — тип возвращаемого значения C
args — массив аргументов, передаваемых в функцию обратного вызова
abi — abi замыкания

Если при подготовке ffi_cif или ffi_prep_closure возникнет ошибка, будет поднято исключение RuntimeError.

Общедоступные методы экземпляра

free() Показать исходный код

static VALUE
closure_free(VALUE self)
{
    fiddle_closure *closure;
    TypedData_Get_Struct(self, fiddle_closure, &closure_data_type, closure);
    if (closure) {
        dealloc(closure);
        RTYPEDDATA_DATA(self) = NULL;
    }
    return RUBY_Qnil;
}

Явно освободить это замыкание. Вы больше не сможете использовать это замыкание.

Если это замыкание уже освобождено, ничего не произойдёт.

freed?() Показать исходный код

static VALUE
closure_freed_p(VALUE self)
{
    fiddle_closure *closure;
    TypedData_Get_Struct(self, fiddle_closure, &closure_data_type, closure);
    return closure ? RUBY_Qfalse : RUBY_Qtrue;
}

Было ли это замыкание явно освобождено.

to_i() Показать исходный код

static VALUE
to_i(VALUE self)
{
    fiddle_closure *closure = get_raw(self);
    return PTR2NUM(closure->code);
}

Возвращает адрес памяти для этого замыкания.

Ruby Core © 1993–2022 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.