عرض مصدر Ruby/Object/define singleton method

{{DISPLAYTITLE:التابع <code>Object.define_singleton_method</code> في روبي}}
يُعرِّف التابع <code>define_singleton_method</code> تابعًا منفردًا (singleton method) في المستقبل (receiver).

== البنية العامة ==
<syntaxhighlight lang="ruby">
define_singleton_method(symbol, method) → symbol
define_singleton_method(symbol) { block } → symbol

</syntaxhighlight>

== المعاملات ==

=== <code>symbol</code> ===
الرمز المُمرَّر إلى التابع والذي سيُعرِّف التابع المنفرد.

=== <code>method</code> ===
التابع المُمرَّر كمعامل. يمكن أن يكون هذا التابع كائنًا من النوع <code>proc</code>، أو <code>Method</code>، أو <code>UnboundMethod</code>.

=== <code>block</code> ===
وسيط اختياري يمثِّل الكتلة المُمرَّرة إلى التابع. إذا أعطي، فستُنفَّذ الكتلة المعطاة كما لو أنَّها من جسم التابع <code>method</code>.

== القيم المعادة ==
يُعاد تابعٌ منفردٌ يمكن استدعائه في المستقبل.

== أمثلة ==
مثالٌ عن استخدام التابع <code>define_singleton_method</code>:<syntaxhighlight lang="ruby">
class A
  class << self
    def class_name
      to_s
    end
  end
end
A.define_singleton_method(:who_am_i) do
  "I am: #{class_name}"
end
A.who_am_i   # ==> "I am: A"

guy = "Bob"
guy.define_singleton_method(:hello) { "#{self}: Hello there!" }
guy.hello    #=>  "Bob: Hello there!"

</syntaxhighlight>

== انظر أيضًا ==
* التابع <code>[[Ruby/Object/singleton class|singleton_class]]</code>: يُعيد صنف الكائن المُنفرد للكائن الذي استدعي معه.
* التابع <code>[[Ruby/Object/singleton method|singleton_method]]</code>: يبحث في التوابع المنفردة فقط بطريقة مشابهة للتابع <code>method</code>.
* التابع <code>[[Ruby/Object/singleton methods|singleton_methods]]</code>: يُعيد مصفوفةً تحوي أسماء توابع الكائن المنفردة.

== مصادر ==
* [http://ruby-doc.org/core-2.5.1/Object.html#method-i-define_singleton_method صفحة التابع define_singleton_method في الصنف Object في توثيق روبي الرسمي.]
[[تصنيف:Ruby]]
[[تصنيف:Ruby Method]]
[[تصنيف:Ruby Object]]