Spec-Zone.ru › Ruby 3.3

класс NameError

Родитель:
StandardError

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

puts foo

вызывает исключение:

NameError: undefined local variable or method `foo' for main:Object

Поскольку имена констант должны начинаться с заглавной буквы:

Integer.const_set :answer, 42

вызывает исключение:

NameError: wrong constant name answer

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

new(msg=nil, name=nil, receiver: nil) → name_error Показать исходный код
static VALUE
name_err_initialize(int argc, VALUE *argv, VALUE self)
{
    ID keywords[1];
    VALUE values[numberof(keywords)], name, options;

    argc = rb_scan_args(argc, argv, "*:", NULL, &options);
    keywords[0] = id_receiver;
    rb_get_kwargs(options, keywords, 0, numberof(values), values);
    name = (argc > 1) ? argv[--argc] : Qnil;
    rb_call_super(argc, argv);
    name_err_init_attr(self, values[0], name);
    return self;
}

Создаёт новое исключение NameError. Если задан параметр name, к нему можно обратиться с помощью метода NameError#name. Параметр receiver позволяет передать объект, в контексте которого произошло исключение. Пример:

[1, 2, 3].method(:rject) # NameError with name "rject" and receiver: Array
[1, 2, 3].singleton_method(:rject) # NameError with name "rject" and receiver: [1, 2, 3]

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

local_variables → массив Показать исходный код
static VALUE
name_err_local_variables(VALUE self)
{
    VALUE vars = rb_attr_get(self, id_local_variables);

    if (NIL_P(vars)) {
        VALUE iseqw = rb_attr_get(self, id_iseq);
        if (!NIL_P(iseqw)) vars = rb_iseqw_local_variables(iseqw);
        if (NIL_P(vars)) vars = rb_ary_new();
        rb_ivar_set(self, id_local_variables, vars);
    }
    return vars;
}

Возвращает список имён локальных переменных, определённых там, где было вызвано это исключение NameError.

Только для внутреннего использования.

name → строка или nil Показать исходный код
static VALUE
name_err_name(VALUE self)
{
    return rb_attr_get(self, id_name);
}

Возвращает имя, связанное с этим исключением NameError.

receiver → объект Показать исходный код
static VALUE
name_err_receiver(VALUE self)
{
    VALUE recv = rb_ivar_lookup(self, id_recv, Qundef);
    if (!UNDEF_P(recv)) return recv;

    VALUE mesg = rb_attr_get(self, id_mesg);
    if (!rb_typeddata_is_kind_of(mesg, &name_err_mesg_data_type)) {
        rb_raise(rb_eArgError, "no receiver is available");
    }

    name_error_message_t *ptr;
    TypedData_Get_Struct(mesg, name_error_message_t, &name_err_mesg_data_type, ptr);
    return ptr->recv;
}

Возвращает объект-получатель, связанный с этим исключением NameError.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API