Method: Object#freeze

Defined in:
object.c

#freeze ⇒ Object

Prevents further modifications to obj. A RuntimeError will be raised if modification is attempted. There is no way to unfreeze a frozen object. See also Object#frozen?.

This method returns self.

a = [ "a", "b", "c" ]
a.freeze
a << "z"

produces:

prog.rb:3:in `<<': can't modify frozen Array (FrozenError)
  from prog.rb:3

Objects of the following classes are always frozen: Integer, Float, Symbol.

Returns:



1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
 
# File 'object.c', line 1286

VALUE
rb_obj_freeze(VALUE obj)
{
    if (!OBJ_FROZEN(obj)) {
  OBJ_FREEZE(obj);
  if (SPECIAL_CONST_P(obj)) {
      rb_bug("special consts should be frozen.");
  }
    }
    return obj;
}