123456789_123456789_123456789_123456789_123456789_

Class: FrozenError

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
Instance Chain:
Inherits: RuntimeError
Defined in: error.c,
error.c

Overview

Raised when there is an attempt to modify a frozen object.

[1, 2, 3].freeze << 4

raises the exception:

FrozenError: can't modify frozen Array

Class Attribute Summary

::Exception - Inherited

.to_tty?

Returns true if exception messages will be sent to a tty.

Class Method Summary

::Exception - Inherited

.exception

With no argument, or if the argument is the same as the receiver, return the receiver.

.new

Construct a new ::Exception object, optionally passing in a message.

Instance Method Summary

::Exception - Inherited

#==

Equality—If obj is not an ::Exception, returns false.

#backtrace

Returns any backtrace associated with the exception.

#backtrace_locations

Returns any backtrace associated with the exception.

#cause

Returns the previous exception ($!) at the time this exception was raised.

#exception

With no argument, or if the argument is the same as the receiver, return the receiver.

#full_message

Returns formatted string of exception.

#inspect

Return this exception's class name and message.

#message

Returns the result of invoking exception.to_s.

#set_backtrace

Sets the backtrace information associated with exc.

#to_s

Returns exception's message (or the name of the exception if no message is set).

Constructor Details

.new(msg = nil, receiver = nil) ⇒ name_error

Construct a new FrozenError exception. If given the receiver parameter may subsequently be examined using the #receiver method.

a = [].freeze
raise FrozenError.new("can't modify frozen array", a)
[ GitHub ]

  
# File 'error.c', line 1430

static VALUE
frozen_err_initialize(int argc, VALUE *argv, VALUE self)
{
    VALUE mesg, recv;

    argc = rb_scan_args(argc, argv, "02", &mesg, &recv);
    if (argc > 1) {
        argc--;
        rb_ivar_set(self, id_recv, recv);
    }
    rb_call_super(argc, argv);
    return self;
}

Instance Method Details

#receiverObject

Alias for NameError#receiver.