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

In Files

  • delegate.rb

Class/Module Index [+]



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_ .

Public Class Methods

new(obj) click to toggle source

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

               # File delegate.rb, line 199
def initialize(obj)
  @_sd_obj = obj

Public Instance Methods

__getobj__() click to toggle source

Returns the current object method calls are being delegated to.

               # File delegate.rb, line 205
def __getobj__
__setobj__(obj) click to toggle source

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
               # File delegate.rb, line 223
def __setobj__(obj)
  raise ArgumentError, "cannot delegate to self" if self.equal?(obj)
  @_sd_obj = obj
clone() click to toggle source

Clone support for the object returned by _getobj_.

               # File delegate.rb, line 229
def clone
  new = super
dup() click to toggle source

Duplication support for the object returned by _getobj_.

               # File delegate.rb, line 235
def dup
  new = super

Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.

If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.

If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.

If you want to help improve the Ruby documentation, please visit Documenting-ruby.org.