класс RubyVM

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

Модуль RubyVM существует только в MRI. RubyVM не определен в других реализациях Ruby, таких как JRuby и TruffleRuby.

Модуль RubyVM предоставляет некоторый доступ к внутренностям MRI. Этот модуль предназначен для очень ограниченных целей, таких как отладка, прототипирование и исследования. Обычные пользователи не должны его использовать. Этот модуль не переносится между реализациями Ruby.

Константы

DEFAULT_PARAMS: DEFAULT_PARAMS Эта константа раскрывает параметры по умолчанию виртуальной машины. Обратите внимание, что изменение этих значений не влияет на выполнение виртуальной машины. Спецификация нестабильна, и вы не должны полагаться на это значение. Конечно, эта константа специфична для MRI.
INSTRUCTION_NAMES: INSTRUCTION_NAMES Список имен инструкций байткода в MRI. Эта константа специфична для MRI.
OPTS: OPTS Список Array опций сборки виртуальной машины. Эта константа специфична для MRI.

Публичные методы класса

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

static VALUE
each_builtin(VALUE self)
{
    st_foreach(loaded_builtin_table, each_builtin_i, 0);
    return Qnil;
}

keep_script_lines → true или false Показать исходный код

static VALUE
vm_keep_script_lines(VALUE self)
{
    return RBOOL(ruby_vm_keep_script_lines);
}

Возвращает текущий keep_script_lines статус. Сейчас он возвращает только true значения false, но в будущем может возвращать и другие объекты.

Обратите внимание, что это API для внутреннего использования Ruby, отладки и исследований. Не используйте его для других целей. Совместимость не гарантируется.

keep_script_lines = true / false Показать исходный код

static VALUE
vm_keep_script_lines_set(VALUE self, VALUE flags)
{
    ruby_vm_keep_script_lines = RTEST(flags);
    return flags;
}

Устанавливает флаг keep_script_lines. Если флаг установлен, все загруженные скрипты записываются в процессе интерпретатора.

mtbl(p1, p2) Показать исходный код

static VALUE
vm_mtbl(VALUE self, VALUE obj, VALUE sym)
{
    vm_mtbl_dump(CLASS_OF(obj), RTEST(sym) ? SYM2ID(sym) : 0);
    return Qnil;
}

mtbl2(p1, p2) Показать исходный код

static VALUE
vm_mtbl2(VALUE self, VALUE obj, VALUE sym)
{
    vm_mtbl_dump(obj, RTEST(sym) ? SYM2ID(sym) : 0);
    return Qnil;
}

stat → Хэш Показать исходный код

stat(hsh) → hsh

stat(Символ) → Число

static VALUE
vm_stat(int argc, VALUE *argv, VALUE self)
{
    static VALUE sym_global_constant_state, sym_class_serial, sym_global_cvar_state;
    VALUE arg = Qnil;
    VALUE hash = Qnil, key = Qnil;

    if (rb_check_arity(argc, 0, 1) == 1) {
        arg = argv[0];
        if (SYMBOL_P(arg))
            key = arg;
        else if (RB_TYPE_P(arg, T_HASH))
            hash = arg;
        else
            rb_raise(rb_eTypeError, "non-hash or symbol given");
    }
    else {
        hash = rb_hash_new();
    }

    if (sym_global_constant_state == 0) {
#define S(s) sym_##s = ID2SYM(rb_intern_const(#s))
        S(global_constant_state);
        S(class_serial);
        S(global_cvar_state);
#undef S
    }

#define SET(name, attr) \
    if (key == sym_##name) \
        return SERIALT2NUM(attr); \
    else if (hash != Qnil) \
        rb_hash_aset(hash, sym_##name, SERIALT2NUM(attr));

    SET(global_constant_state, ruby_vm_global_constant_state);
    SET(class_serial, ruby_vm_class_serial);
    SET(global_cvar_state, ruby_vm_global_cvar_state);
#undef SET

    if (!NIL_P(key)) { /* matched key should return above */
        rb_raise(rb_eArgError, "unknown key: %"PRIsVALUE, rb_sym2str(key));
    }

    return hash;
}

Возвращает Hash, содержащий зависящие от реализации счётчики внутри виртуальной машины.

Этот хэш содержит информацию о сериализации кэша методов/констант:

{
  :global_constant_state=>481,
  :class_serial=>9029
}

Содержимое хэша специфично для реализации и может быть изменено в будущем.

Этот метод ожидается, что он будет работать только в C Ruby.

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