صفحة الصنف UnboundMethod في روبي

من موسوعة حسوب

روبي تدعم شكلين من التوابع الكائنية (objectified methods). يستخدم الصنف Method لتمثيل التوابع المرتبطة بكائن معين، يمكن إنشاء كائنات التوابع من هذا النوع عبر Object#method.

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

لا يمكن استدعاء التوابع الحرة إلا بعد ربطها بكائن ما. ويجب أن يعيد التعبير UnboundMethod.kind_of? A القيمة true، حيث A يمثل الصنف الأصلي للتابع.

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‎

التوابع الحرة ستكون مرجعًا للتوابع عند ربطها: لن تؤثر التغييرات اللاحقة على الصنف الأساسي على التابع الحر.

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‎

توابع النسخة العامة (Public Instance Methods)

التابع ==

معامل التساوي.

التابع arity

يعيد معامل الرتبة arity مؤشرا لعدد الوسائط المقبولة من قبل التابع.

التابع bind

يربط التابع bind التابع الحر بالكائن المعطى.

التابع clone

يعيد التابع clone نسخة من هذا التابع.

التابع eql?‎

يتحقق من تساوي تابعين.

التابع hash

يعيد التابع hash رمز التكويد (hash) المقابل التابع الحر الذي استُدعي معه.

التابع inspect

يعيد التابع inspect اسم التابع الأصلي (underlying method).

التابع name

يعيد التابع name اسم التابع.

التابع original_name

يعيد التابع original_name الاسم الأصلي التابع الحر الذي استُدعي معه.

التابع owner

يعيد التابع owner الصنف أو الوحدة (module) التي تعرف التابع الحر.

التابع parameters

يعيد التابع parameters معلومات عن وسائط التابع الحر الذي استُدعي معه.

التابع source_location

يعيد التابع source_location اسم الملف المصدر لروبي ورقم السطر الذي يحتوي هذا التابع.

التابع super_method

يعيد التابع super_method كائنا من النوع Method للصنف الأب (superclass)، حتى يمكن استدعاؤه عند استخدام super.

التابع to_s

يعيد to_s اسم التابع الأصلي (underlying method).

مصادر