عرض مصدر Ruby/UnboundMethod

<noinclude>{{DISPLAYTITLE: صفحة الصنف <code>UnboundMethod</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby UnboundMethod]]
روبي تدعم شكلين من التوابع الكائنية (objectified methods). يستخدم [[Ruby/Class|الصنف]]  <code>Method</code> لتمثيل التوابع المرتبطة بكائن معين، يمكن إنشاء كائنات التوابع من هذا النوع عبر <code>[[Ruby/Object/method|Object#method]]</code>.

تدعم روبي أيضًا التوابع الحرة (unbound methods)؛ وهي كائنات توابع غير مرتبطة بكائن معين. يمكن إنشاؤها إما عن طريق استدعاء <code>[[Ruby/Module/instance method|Module#instance_method]]</code>، أو عن طريق استدعاء <code>unbind</code> على تابع مرتبط (bound method object). نتيجة كليهما ستكون تابعا حرا (<code>UnboundMethod</code>).

لا يمكن استدعاء التوابع الحرة إلا بعد ربطها بكائن ما. ويجب أن يعيد التعبير <code>UnboundMethod.kind_of? A</code> القيمة <code>true</code>،  حيث <code>A</code> يمثل الصنف الأصلي للتابع.<syntaxhighlight lang="ruby">class Square
  def area
    @side * @side
  end
  def initialize(side)
    @side = side
  end
end
area_un = Square.instance_method(:area)
s = Square.new(12)
area = area_un.bind(s)
area.call   #=> 144‎</syntaxhighlight>التوابع الحرة ستكون مرجعًا للتوابع عند ربطها: لن تؤثر التغييرات اللاحقة على الصنف الأساسي على التابع الحر.<syntaxhighlight lang="ruby">class Test
  def test
    :original
  end
end
um = Test.instance_method(:test)
class Test
  def test
    :modified
  end
end
t = Test.new
t.test            #=> :modified
um.bind(t).call   #=> :original‎</syntaxhighlight>
==توابع النسخة العامة (Public Instance Methods)==
===[[Ruby/UnboundMethod/equality operator| التابع ==]]===
معامل التساوي.
===[[Ruby/UnboundMethod/arity| التابع arity]]===
يعيد معامل الرتبة arity مؤشرا لعدد الوسائط المقبولة من قبل التابع.
===[[Ruby/UnboundMethod/bind| التابع bind]]===
يربط التابع <code>bind</code> [[Ruby/UnboundMethod|التابع الحر]] بالكائن المعطى.
===[[Ruby/UnboundMethod/clone| التابع clone]]===
يعيد التابع <code>clone</code> نسخة من هذا التابع.
===[[Ruby/UnboundMethod/eql-3F| التابع eql?‎]]===
يتحقق من تساوي تابعين.
===[[Ruby/UnboundMethod/hash| التابع hash]]===
يعيد التابع <code>hash</code> رمز التكويد (hash) المقابل [[Ruby/UnboundMethod|التابع الحر]] الذي استُدعي معه.
===[[Ruby/UnboundMethod/inspect| التابع inspect]]===
يعيد التابع <code>inspect</code> اسم التابع الأصلي (underlying method).
===[[Ruby/UnboundMethod/name| التابع name]]===
يعيد التابع <code>name</code> اسم التابع.
===[[Ruby/UnboundMethod/original name| التابع original_name]]===
يعيد التابع <code>original_name</code> الاسم الأصلي [[Ruby/UnboundMethod|التابع الحر]] الذي استُدعي معه.
===[[Ruby/UnboundMethod/owner| التابع owner]]===
يعيد التابع <code>owner</code> الصنف أو الوحدة (module) التي تعرف [[Ruby/UnboundMethod|التابع الحر]].
===[[Ruby/UnboundMethod/parameters| التابع parameters]]===
يعيد التابع <code>parameters</code> معلومات عن وسائط [[Ruby/UnboundMethod|التابع الحر]] الذي استُدعي معه.
===[[Ruby/UnboundMethod/source location| التابع source_location]]===
يعيد التابع <code>source_location</code> اسم الملف المصدر لروبي ورقم السطر الذي يحتوي هذا التابع.
===[[Ruby/UnboundMethod/super method| التابع super_method]]===
يعيد التابع <code>super_method</code> كائنا من النوع <code>[[Ruby/Method|Method]]</code> للصنف الأب (superclass)، حتى يمكن استدعاؤه عند استخدام <code>super</code>.
===[[Ruby/UnboundMethod/to s| التابع to_s]]===
يعيد <code>to_s</code> اسم التابع الأصلي (underlying method).
==مصادر==
*[http://ruby-doc.org/core-2.5.1/UnboundMethod.html قسم  الصنف UnboundMethod في توثيق روبي الرسمي.]