Changeset 8311 for trunk/activesupport/lib/active_support/core_ext/module/delegation.rb

Timestamp:

12/05/07 21:45:35 (9 months ago)

Author:

marcel

Message:

Document that the delegate method can delegate to things other than just methods. Closes #7184 [dcmanges, jeremymcanally]

Files:

• trunk/activesupport/lib/active_support/core_ext/module/delegation.rb (modified) (2 diffs)

trunk/activesupport/lib/active_support/core_ext/module/delegation.rb

@@ -6 +6 @@
-  #
-  # Delegation is particularly useful with Active Record associations:
+  #
-  #   class Greeter < ActiveRecord::Base
-  #     def hello()   "hello"   end
@@ -26 +27 @@
-  #
-  #   Foo.new.goodbye # => "goodbye"
+  #
+  # Methods can be delegated to instance variables, class variables, or constants
+  # by providing the variable as a symbol:
+  #   class Foo
+  #     CONSTANT_ARRAY = [0,1,2,3]
+  #     @@class_array  = [4,5,6,7]
+  #     
+  #     def initialize
+  #       @instance_array = [8,9,10,11]
+  #     end
+  #     delegate :sum, :to => :CONSTANT_ARRAY
+  #     delegate :min, :to => :@@class_array
+  #     delegate :max, :to => :@instance_array
+  #   end
+  #
+  #   Foo.new.sum # => 6
+  #   Foo.new.min # => 4
+  #   Foo.new.max # => 11
+  #
-  def delegate(*methods)
-    options = methods.pop