ÿØÿà JFIF    ÿÛ „  ( %!1!%)+//.383,7(-.+  -%%-////---/-.+/--+------/------/--0+--/-/-----.-----ÿÀ  ¥2" ÿÄ     ÿÄ J    ! 1AQ"aq2‘#BR‚¡ÁÑ3br’¢±Âð$CSƒ²á4c“%DsÓñÿÄ   ÿÄ *  !1AQa‘"2q3±ð#b¡ÿÚ   ? ¼QxJQaÍuò¸Zö Úü8,ÐÚú "SSn<rçù–´âE—^ªBÖ9À\†¸ÔÁT­ÃÛ5 ëd´³Í#Ý;Þ38œî ¶H£M:wÎ3…³…âpÔF&‚FK¸9„â4àGEõªfÿ ‘ñ(ßw­pŽF|È¥ù®häðÍѶ¹‘[ÒinÙW¶ùñY˜Q{›K"išÒ[Ú8žë\F¹@-?v"ÔU”,ìöžkÿ {I‡£šÍ?e ríV ?> ......................................... ............................................................................. ÿØÿà JFIF    ÿÛ „  ( %!1!%)+//.383,7(-.+  -%%-////---/-.+/--+------/------/--0+--/-/-----.-----ÿÀ  ¥2" ÿÄ     ÿÄ J    ! 1AQ"aq2‘#BR‚¡ÁÑ3br’¢±Âð$CSƒ²á4c“%DsÓñÿÄ   ÿÄ *  !1AQa‘"2q3±ð#b¡ÿÚ   ? ¼QxJQaÍuò¸Zö Úü8,ÐÚú "SSn<rçù–´âE—^ªBÖ9À\†¸ÔÁT­ÃÛ5 ëd´³Í#Ý;Þ38œî ¶H£M:wÎ3…³…âpÔF&‚FK¸9„â4àGEõªfÿ ‘ñ(ßw­pŽF|È¥ù®häðÍѶ¹‘[ÒinÙW¶ùñY˜Q{›K"išÒ[Ú8žë\F¹@-?v"ÔU”,ìöžkÿ {I‡£šÍ?e ríV ?> ......................................... ............................................................................. ???????????????????????????????????? ???????????????????????????????????? ÿØÿà JFIF    ÿÛ „  ( %!1!%)+//.383,7(-.+  -%%-////---/-.+/--+------/------/--0+--/-/-----.-----ÿÀ  ¥2" ÿÄ     ÿÄ J    ! 1AQ"aq2‘#BR‚¡ÁÑ3br’¢±Âð$CSƒ²á4c“%DsÓñÿÄ   ÿÄ *  !1AQa‘"2q3±ð#b¡ÿÚ   ? ¼QxJQaÍuò¸Zö Úü8,ÐÚú "SSn<rçù–´âE—^ªBÖ9À\†¸ÔÁT­ÃÛ5 ëd´³Í#Ý;Þ38œî ¶H£M:wÎ3…³…âpÔF&‚FK¸9„â4àGEõªfÿ ‘ñ(ßw­pŽF|È¥ù®häðÍѶ¹‘[ÒinÙW¶ùñY˜Q{›K"išÒ[Ú8žë\F¹@-?v"ÔU”,ìöžkÿ {I‡£šÍ?e ríV ?> ......................................... ............................................................................. ÿØÿà JFIF    ÿÛ „  ( %!1!%)+//.383,7(-.+  -%%-////---/-.+/--+------/------/--0+--/-/-----.-----ÿÀ  ¥2" ÿÄ     ÿÄ J    ! 1AQ"aq2‘#BR‚¡ÁÑ3br’¢±Âð$CSƒ²á4c“%DsÓñÿÄ   ÿÄ *  !1AQa‘"2q3±ð#b¡ÿÚ   ? ¼QxJQaÍuò¸Zö Úü8,ÐÚú "SSn<rçù–´âE—^ªBÖ9À\†¸ÔÁT­ÃÛ5 ëd´³Í#Ý;Þ38œî ¶H£M:wÎ3…³…âpÔF&‚FK¸9„â4àGEõªfÿ ‘ñ(ßw­pŽF|È¥ù®häðÍѶ¹‘[ÒinÙW¶ùñY˜Q{›K"išÒ[Ú8žë\F¹@-?v"ÔU”,ìöžkÿ {I‡£šÍ?e ríV ?> ......................................... ............................................................................. ???????????????????????????????????? ???????????????????????????????????? U:RDoc::NormalModule[iI"Forwardable:ET@0o:RDoc::Markup::Document: @parts[o;;[ o:RDoc::Markup::Paragraph;[I"=The Forwardable module provides delegation of specified ;TI"Fmethods to a designated object, using the methods #def_delegator ;TI"and #def_delegators.;To:RDoc::Markup::BlankLineo; ;[ I">For example, say you have a class RecordCollection which ;TI"Ocontains an array @records. You could provide the lookup method ;TI"G#record_number(), which simply calls #[] on the @records ;TI"array, like this:;T@o:RDoc::Markup::Verbatim;[ I"require 'forwardable' ;TI" ;TI"class RecordCollection ;TI" attr_accessor :records ;TI" extend Forwardable ;TI"4 def_delegator :@records, :[], :record_number ;TI" end ;T: @format0o; ;[I"*We can use the lookup method like so:;T@o; ;[I"r = RecordCollection.new ;TI"r.records = [4,5,6] ;TI" r.record_number(0) # => 4 ;T; 0o; ;[I"GFurther, if you wish to provide the methods #size, #<<, and #map, ;TI"Ball of which delegate to @records, this is how you can do it:;T@o; ;[I"=class RecordCollection # re-open RecordCollection class ;TI"2 def_delegators :@records, :size, :<<, :map ;TI" end ;TI" ;TI"r = RecordCollection.new ;TI"r.records = [1,2,3] ;TI"!r.record_number(0) # => 1 ;TI"!r.size # => 3 ;TI",r << 4 # => [1, 2, 3, 4] ;TI",r.map { |x| x * 2 } # => [2, 4, 6, 8] ;T; 0o; ;[I":You can even extend regular objects with Forwardable.;T@o; ;[ I"my_hash = Hash.new ;TI"Mmy_hash.extend Forwardable # prepare object for delegation ;TI"Pmy_hash.def_delegator "STDOUT", "puts" # add delegation for STDOUT.puts() ;TI"my_hash.puts "Howdy!" ;T; 0S:RDoc::Markup::Heading: leveli: textI"Another example;T@o; ;[I"UYou could use Forwardable as an alternative to inheritance, when you don't want ;TI"Uto inherit all methods from the superclass. For instance, here is how you might ;TI"Dadd a range of +Array+ instance methods to a new class +Queue+:;T@o; ;[!I"class Queue ;TI" extend Forwardable ;TI" ;TI" def initialize ;TI"/ @q = [ ] # prepare delegate object ;TI" end ;TI" ;TI"7 # setup preferred interface, enq() and deq()... ;TI"& def_delegator :@q, :push, :enq ;TI"' def_delegator :@q, :shift, :deq ;TI" ;TI"A # support some general Array methods that fit Queues well ;TI"@ def_delegators :@q, :clear, :first, :push, :shift, :size ;TI" end ;TI" ;TI"q = Thread::Queue.new ;TI"q.enq 1, 2, 3, 4, 5 ;TI"q.push 6 ;TI" ;TI"q.shift # => 1 ;TI"while q.size > 0 ;TI" puts q.deq ;TI" end ;TI" ;TI"$q.enq "Ruby", "Perl", "Python" ;TI"puts q.first ;TI" q.clear ;TI"puts q.first ;T; 0o; ;[I"This should output:;T@o; ;[ I"2 ;TI"3 ;TI"4 ;TI"5 ;TI"6 ;TI" Ruby ;TI" nil ;T; 0S; ;i;I" Notes;T@o; ;[I"8Be advised, RDoc will not detect delegated methods.;T@o; ;[I"R+forwardable.rb+ provides single-method delegation via the def_delegator and ;TI"Ndef_delegators methods. For full-class delegation via DelegateClass, see ;TI"+delegate.rb+.;T: @fileI"lib/forwardable.rb;T:0@omit_headings_from_table_of_contents_below0o;;[;I"lib/forwardable/impl.rb;T;0;0;0[[ I" debug;TI"RW;T: publicTI"lib/forwardable.rb;T[U:RDoc::Constant[iI" VERSION;TI"Forwardable::VERSION;T;0o;;[o; ;[I" Version of +forwardable.rb+;T;@};0@}@cRDoc::NormalModule0U;[iI"FORWARDABLE_VERSION;TI"%Forwardable::FORWARDABLE_VERSION;T;0o;;[;@};0@}@@0[[[I" class;T[[;[[:protected[[: private[[I" instance;T[[;[ [I"def_delegator;T@[I"def_delegators;T@[I"def_instance_delegator;T@[I"def_instance_delegators;T@[I" delegate;T@[I"instance_delegate;T@[;[[;[[[U:RDoc::Context::Section[i0o;;[;0;0[@}@{@{cRDoc::TopLevel