عرض مصدر Ruby/Object/tap

{{DISPLAYTITLE:التابع <code>Object.tap</code> في روبي}}

يُدخل التابع <code>tap</code> الكائن المعطى إلى الكتلة (block)، ثم يعيده. الهدف الأساسي من هذا التابع هو "التداخل في" سلسلة التوابع، بهدف تنفيذ عملياتٍ على النتائج الوسطية التي تنتج خلال تنفيذ السلسلة.

== البنية العامة ==
<syntaxhighlight lang="ruby">
tap {|x| block } → obj
</syntaxhighlight>

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

=== <code>x</code> ===
الكائن المراد إدخاله إلى الكتلة.

=== <code>block</code> ===
الكتلة المراد تنفيذها على الكائن.

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

== أمثلة ==
مثالٌ عن استخدام التابع <code>tap</code>:<syntaxhighlight lang="ruby">
(1..10)                  .tap {|x| puts "original: #{x}" }
  .to_a                  .tap {|x| puts "array:    #{x}" }
  .select {|x| x.even? } .tap {|x| puts "evens:    #{x}" }
  .map {|x| x*x }        .tap {|x| puts "squares:  #{x}" }

</syntaxhighlight>

== انظر أيضًا ==
*التابع <code>[[Ruby/Object/class|class]]</code>: يعيد صنف الكائن المعطى.
*التابع <code>[[Ruby/Object/clone|clone]]</code>: يُنتج نسخةً سطحيةً من الكائن المعطى.

* التابع <code>[[Ruby/Object/dup|dup]]</code>: ينتج نسخةً سطحية من الكائن.

* التابع <code>[[Ruby/Object/yield self|yield_self]]</code>: يُدخل الكائن المعطى إلى الكتلة ويُعيد ناتج تنفيذ هذه الكتلة.
== مصادر ==
* [http://ruby-doc.org/core-2.5.1/Object.html#method-i-tap صفحة التابع tap في الصنف Object في توثيق روبي الرسمي.]
[[تصنيف:Ruby]]
[[تصنيف:Ruby Method]]
[[تصنيف:Ruby Object]]