Class SimpleDelegator
In: delegate.rb
Parent: Delegator

A concrete implementation of Delegator, this class provides the means to delegate all supported method calls to the object passed into the constructor and even to change the object being delegated to at a later time with __setobj__ .

Methods

__getobj__   __setobj__   clone   dup   new  

Public Class methods

Pass in the obj you would like to delegate method calls to.

[Source]

# File delegate.rb, line 201
  def initialize(obj)
    super
    @_sd_obj = obj
  end

Public Instance methods

Returns the current object method calls are being delegated to.

[Source]

# File delegate.rb, line 207
  def __getobj__
    @_sd_obj
  end

Changes the delegate object to obj.

It‘s important to note that this does not cause SimpleDelegator‘s methods to change. Because of this, you probably only want to change delegation to objects of the same type as the original delegate.

Here‘s an example of changing the delegation object.

  names = SimpleDelegator.new(%w{James Edward Gray II})
  puts names[1]    # => Edward
  names.__setobj__(%w{Gavin Sinclair})
  puts names[1]    # => Sinclair

[Source]

# File delegate.rb, line 225
  def __setobj__(obj)
    raise ArgumentError, "cannot delegate to self" if self.equal?(obj)
    @_sd_obj = obj
  end

Clone support for the object returned by __getobj__.

[Source]

# File delegate.rb, line 231
  def clone
    super
    __setobj__(__getobj__.clone)
  end

Duplication support for the object returned by __getobj__.

[Source]

# File delegate.rb, line 236
  def dup(obj)
    super
    __setobj__(__getobj__.dup)
  end

[Validate]

ruby-doc.org is a community service provided by Happy Camper Studios, a Phoenix, Arizona, Ruby application development company.

Documentation content on ruby-doc.org is provided by remarkable members of the Ruby community.

For more information on the Ruby programming language, visit ruby-lang.org.

Want to help improve Ruby's API docs? See Ruby Documentation Guidelines.