Extended maintenance of Ruby versions 1.8.7 and 1.9.2 ended on July 31, 2014. Read more

In Files

  • error.c





Raised when a given name is invalid or undefined.

puts foo

raises the exception:

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

Since constant names must start with a capital:

Fixnum.const_set :answer, 42

raises the exception:

NameError: wrong constant name answer

Public Class Methods

new(msg [, name]) → name_error click to toggle source

Construct a new NameError exception. If given the name parameter may subsequently be examined using the NameError.name method.

               static VALUE
name_err_initialize(int argc, VALUE *argv, VALUE self)
    VALUE name;

    name = (argc > 1) ? argv[--argc] : Qnil;
    rb_call_super(argc, argv);
    rb_iv_set(self, "name", name);
    return self;

Public Instance Methods

name → string or nil click to toggle source

Return the name associated with this NameError exception.

               static VALUE
name_err_name(VALUE self)
    return rb_attr_get(self, rb_intern("name"));
to_s → string click to toggle source

Produce a nicely-formatted string representing the NameError.

               static VALUE
name_err_to_s(VALUE exc)
    VALUE mesg = rb_attr_get(exc, rb_intern("mesg"));
    VALUE str = mesg;

    if (NIL_P(mesg)) return rb_class_name(CLASS_OF(exc));
    if (str != mesg) {
        rb_iv_set(exc, "mesg", mesg = str);
    if (OBJ_TAINTED(exc)) OBJ_TAINT(mesg);
    return mesg;