عرض مصدر Ruby/Hash/transform values!

<noinclude>{{DISPLAYTITLE:التابع <code>Hash.transform_values!‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Hash]]
يستدعي التابع <code>transform_values!‎</code> الكتلة المعطاة مرةً واحدةً لكل قيمة من قيم الكائن [[Ruby/Hash|<code>Hash</code>]] المعطى، ويستبدل به القيمة الجديد التي تعيدها الكتلة، ثم يعيد هذا الكائن. لا يُغيّر هذا التابع المفاتيح.

إذا لم تُعطَ أية كتلة، فسيُعاد كائن من النوع <code>[[Ruby/Enumerator|enumerator]]</code> بدلًا من ذلك.
==البنية العامة==
<syntaxhighlight lang="ruby">transform_values! {|value| block } → hsh
transform_values! → an_enumerator</syntaxhighlight>
==القيمة المعادة==
يعاد الكائن [[Ruby/Hash|<code>Hash</code>]] المعطى نفسه بعد تبديل قيمه إلى القيم التي تعيدها الكتلة <code>block</code> عند تمرير قيمة المفتاح القديم إليها، أو يعاد كائن من النوع <code>[[Ruby/Enumerator|enumerator]]</code> إن لم تُعطَ أية كتلة.    

== أمثلة ==
مثال على استعمال التابع <code>transform_keys!‎</code>:<syntaxhighlight lang="ruby">
h = { a: 1, b: 2, c: 3 }
h.transform_values! {|v| v * v + 1 }  #=> { a: 2, b: 5, c: 10 }
h.transform_values!(&:to_s)           #=> { a: "2", b: "5", c: "10" }
h.transform_values!.with_index {|v, i| "#{v}.#{i}" }
                                      #=> { a: "2.0", b: "5.1", c: "10.2" }
</syntaxhighlight>
==انظر أيضا==
* التابع <code>[[Ruby/Hash/transform keys|transform_keys]]</code>: يعيد كائن جديد من النوع <code>[[Ruby/Hash|Hash]]</code> مع ناتج تنفيذ الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه.
* التابع <code>[[Ruby/Hash/transform keys!|transform_keys!‎]]</code>: يستدعي الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح الكائن [[Ruby/Hash|<code>Hash</code>]] المعطى، ويستبدل به المفتاح الجديد الذي تعيده الكتلة، ثم يعيد هذا الكائن.
* التابع <code>[[Ruby/Hash/transform values|transform_values]]</code>: يعيد كائن جديد من النوع <code>[[Ruby/Hash|Hash]]</code> مع ناتج تنفيذ الكتلة المعطاة مرةً واحدةً لكل قيمة من قيم الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه.

==مصادر==
*[http://ruby-doc.org/core-2.5.1/Hash.html#method-i-transform_values-21 قسم التابع transform_values!‎ في الصنف Hash في توثيق روبي الرسمي.]