класс Binding

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

Объекты класса Binding инкапсулируют контекст выполнения в определенной точке кода и сохраняют этот контекст для дальнейшего использования. Переменные, методы, значение self, и, возможно, блок итератора, доступные в этом контексте, также сохраняются. Объекты Binding могут быть созданы с помощью Kernel#binding, и доступны в обратном вызове Kernel#set_trace_func.

Эти объекты связывания могут быть переданы как второй аргумент метода Kernel#eval, создавая среду для оценки.

class Demo
  def initialize(n)
    @secret = n
  end
  def get_binding
    binding
  end
end

k1 = Demo.new(99)
b1 = k1.get_binding
k2 = Demo.new(-3)
b2 = k2.get_binding

eval("@secret", b1)   #=> 99
eval("@secret", b2)   #=> -3
eval("@secret")       #=> nil

Объекты Binding не имеют методов, специфичных для класса.

Публичные методы экземпляров

eval(строка [, имя_файла [,номер_строки]]) → obj Показать исходный код

static VALUE
bind_eval(int argc, VALUE *argv, VALUE bindval)
{
    VALUE args[4];

    rb_scan_args(argc, argv, "12", &args[0], &args[2], &args[3]);
    args[1] = bindval;
    return rb_f_eval(argc+1, args, Qnil /* self will be searched in eval */);
}

Вычисляет выражение(я) Руби в строке в контексте связывания. Если присутствуют необязательные параметры имя_файла и номер_строки, они будут использоваться при сообщении о синтаксических ошибках.

def get_binding(param)
  binding
end
b = get_binding("hello")
b.eval("param")   #=> "hello"

local_variable_defined?(символ) → obj Показать исходный код

static VALUE
bind_local_variable_defined_p(VALUE bindval, VALUE sym)
{
    ID lid = check_local_id(bindval, &sym);
    const rb_binding_t *bind;

    if (!lid) return Qfalse;

    GetBindingPtr(bindval, bind);
    return get_local_variable_ptr(bind->env, lid) ? Qtrue : Qfalse;
}

Возвращает true, если локальная переменная symbol существует.

def foo
  a = 1
  binding.local_variable_defined?(:a) #=> true
  binding.local_variable_defined?(:b) #=> false
end

Этот метод — короткая версия следующего кода:

binding.eval("defined?(#{symbol}) == 'local-variable'")

local_variable_get(символ) → obj Показать исходный код

static VALUE
bind_local_variable_get(VALUE bindval, VALUE sym)
{
    ID lid = check_local_id(bindval, &sym);
    const rb_binding_t *bind;
    const VALUE *ptr;

    if (!lid) goto undefined;

    GetBindingPtr(bindval, bind);

    if ((ptr = get_local_variable_ptr(bind->env, lid)) == NULL) {
      undefined:
        rb_name_error_str(sym, "local variable `%"PRIsVALUE"' not defined for %"PRIsVALUE,
                          sym, bindval);
    }

    return *ptr;
}

Возвращает значение локальной переменной symbol.

def foo
  a = 1
  binding.local_variable_get(:a) #=> 1
  binding.local_variable_get(:b) #=> NameError
end

Этот метод — короткая версия следующего кода:

binding.eval("#{symbol}")

local_variable_set(символ, obj) → obj Показать исходный код

static VALUE
bind_local_variable_set(VALUE bindval, VALUE sym, VALUE val)
{
    ID lid = check_local_id(bindval, &sym);
    rb_binding_t *bind;
    VALUE *ptr;

    if (!lid) lid = rb_intern_str(sym);

    GetBindingPtr(bindval, bind);
    if ((ptr = get_local_variable_ptr(bind->env, lid)) == NULL) {
        /* not found. create new env */
        ptr = rb_binding_add_dynavars(bind, 1, &lid);
    }

    *ptr = val;

    return val;
}

Установить локальную переменную с именем symbol как obj.

def foo
  a = 1
  bind = binding
  bind.local_variable_set(:a, 2) # set existing local variable `a'
  bind.local_variable_set(:b, 3) # create new local variable `b'
                                 # `b' exists only in binding

  p bind.local_variable_get(:a)  #=> 2
  p bind.local_variable_get(:b)  #=> 3
  p a                            #=> 2
  p b                            #=> NameError
end

Этот метод аналогичен следующему коду:

binding.eval("#{symbol} = #{obj}")

если obj может быть выведен в коде Руби.

local_variables → Массив Показать исходный код

static VALUE
bind_local_variables(VALUE bindval)
{
    const rb_binding_t *bind;

    GetBindingPtr(bindval, bind);
    return rb_vm_env_local_variables(bind->env);
}

Возвращает имена локальных переменных связывания как символы.

def foo
  a = 1
  2.times do |n|
    binding.local_variables #=> [:a, :n]
  end
end

Этот метод — короткая версия следующего кода:

binding.eval("local_variables")

receiver → объект Показать исходный код

static VALUE
bind_receiver(VALUE bindval)
{
    const rb_binding_t *bind;
    const rb_env_t *env;

    GetBindingPtr(bindval, bind);
    GetEnvPtr(bind->env, env);
    return env->block.self;
}

Возвращает связанный объект-приемник объекта связывания.

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