Ruby 1.9.3 リファレンスマニュアル > ライブラリ一覧 > forwardableライブラリ > Forwardableモジュール

module Forwardable

クラスの継承リスト: Forwardable

要約

クラスに対し、メソッドの委譲機能を定義するモジュールです。

使い方

クラスに対して Object#extend して使います。Module#include でないところに注意して下さい。

例:

class Foo
  extend Forwardable

  def_delegators("@out", "printf", "print")
  def_delegators(:@in, :gets)
  def_delegator(:@contents, :[], "content_at")
end
f = Foo.new
f.printf ...
f.gets
f.content_at(1)

特異メソッド

debug -> bool

委譲部分をバックトレースに含めるかどうかの状態を返します。

バックトレースを含める設定となっている時、真を返します。 デフォルトは含めない設定となっています。

debug= -> bool

委譲部分をバックトレースに含めるかどうかの状態を設定します。

インスタンスメソッド

def_instance_delegator(accessor, method, ali = method) -> nil
def_delegator(accessor, method, ali = method) -> nil

メソッドの委譲先を設定します。

[PARAM] accessor:
委譲先のオブジェクト
[PARAM] method:
委譲先のメソッド
[PARAM] ali:
委譲元のメソッド

委譲元のオブジェクトで ali が呼び出された場合に、 委譲先のオブジェクトの method へ処理が委譲されるようになります。

委譲元と委譲先のメソッド名が同じ場合は, ali を省略することが可能です。

def_delegator は def_instance_delegator の別名になります。

def_instance_delegators(accessor, *methods) -> nil
def_delegators(accessor, *methods) -> nil

メソッドの委譲先をまとめて設定します。

[PARAM] accessor:
委譲先のオブジェクト
[PARAM] methods:
委譲するメソッドのリスト

委譲元のオブジェクトで methods のそれぞれのメソッドが呼び出された場合に、 委譲先のオブジェクトの同名のメソッドへ処理が委譲されるようになります。

def_delegators は def_instance_delegators の別名になります。

module Forwardable