التابع Module.module_function‎ في روبي

ينشئ التابع module_function دوال وحدة (module functions) للتوابع المعطاة. يمكن استدعاء هذه الدوال مع الوحدة كمُستقبِلات (receiver)، كما يمكن أن تصبح متاحةً كتوابع نسخة (instance methods) للأصناف التي تُمزج (mix) في الوحدة. دوال النوع Module هي نسخ من الدوال الأصلية، وبالتالي يمكن تغييرها بشكل مستقل.

توابع النسخة (instance-method) ستتحول إلى خاصة. وإذا تم استدعاء التابع module_function دون معاملات، فستصبح التوابع التي ستُعرَّف لاحقًا دوال وحدة (module functions).

تُحوّل الوسائط النصية إلى رموز.

البنية العامة

module_function(symbol, ...) → self
module_function(string, ...) → self‎

المعاملات

symbol‎

كائن من النوع Symbol يمثل اسم الدالة المراد إنشاؤها.

string‎

سلسلة نصية تمثل اسم الدالة المراد إنشاؤها.

...

كائن من النوع Symbol أو سلسلة نصية تمثل اسم الدالة المراد إنشاؤها.

القيمة المعادة

يعاد الكائن المعطى.

أمثلة

مثال على استخدام التابع module_function‎:

module Mod
  def one
    "This is one"
  end
  module_function :one
end
class Cls
  include Mod
  def call_one
    one
  end
end
Mod.one     #=> "This is one"
c = Cls.new
c.call_one  #=> "This is one"
module Mod
  def one
    "This is the new one"
  end
end
Mod.one     #=> "This is one"
c.call_one  #=> "This is the new one"‎

انظر أيضا

• التابع module_exec: يقيّم الكتلة الممررة في سياق الصنف/الوحدة.
• التابع name: يعيد اسم الوحدة.

مصادر

• قسم التابع module_function‎ في الصنف Module‎ في توثيق روبي الرسمي.